所有文档

          内容分发网络 CDN

          通过CLI使用CDN服务

          BCE CLI通过cdn子命令来访问CDN服务,缓存刷新和缓存预加载。

          CLI使用多层命令结构,所有的命令以bce开头,[options]表示BCE CLI支持的选项,<service>表示CLI所支持的服务,如BOS、CDN等,每个服务拥有多个特定的子命令。

          $ bce [options] [<service> <command> [parameters [options]]]

          参数解释

          参数项 取值 说明
          options BCE通用的Option,取值为-c-v-h-d--conf-path -
          service 使用CDN服务取值为cdn -
          command 取值为:lsprefetchpurge 各命令的作用请参见命令功能描述。
          parameters 各命令的parameters请参见命令功能描述。 -
          +options cdn命令的Option,取值为-a-h等。 cdn各命令可配置的option不一样,详细的使用方法请参见各命令行解释。

          CLI通用Option

          • 查看帮助:可以在任意命令后面添加-h--help来查看该命令的帮助信息。

            	    $ bce -h
            	    $ bce cdn -h
            	    $ bce cdn ls --help
          • 查看、设置AK、SK等配置信息:-c/--configure

              $ bce -c [<conf-path>]
          • 查看版本信息:-v/--version

              $ bce -v
          • 查看debug信息:-d/--debug

              $ bce -d cdn ls

          -d/--debug命令不能单独使用,必须与service结合使用。

          • 使用指定配置文件:--conf-path

              $ bce --conf-path ./conf-sample/ cdn ls

          不使用--conf-path命令时,默认使用用户主目录~/.bce下的配置。

          域名管理

          列举域名

          描述: 列举所有域名。

          命令格式: $ bce cdn ls [-a, --all]

          操作示例: $ bce cdn ls

          返回示例:

          my.domain.com
          my1.domain.com
          my10.domain.com
          ...

          缓存管理

          刷新缓存

          描述: 用于清除已经缓存的文件,用户24小时之内最多提交20000个URL刷新请求或者200个目录刷新请求。

          命令格式: bce cdn purge [--url] [--directory] <url> <path>

          说明:

          • --url:提交文件刷新请求
          • --directory:提交目录刷新请求,此时path 必须以/结尾

          操作示例:

          • 提交文件刷新请求

            		$ bce cdn purge --url http://my.domain.com/1.jpg
          • 提交目录刷新请求

            		$ bce cdn purge --directory http://my.domain.com/to/path/

          返回示例: purge ok, id: e0e9c9fc-a8c6-4c60-b9c7-6118a8d44698

          查询刷新状态

          描述: 查询刷新请求的状态。

          命令格式: $ bce cdn purge --query <purge-id>

          说明:

          purge-id 为之前提交刷新缓存任务后返回的Id

          操作示例: $ bce cdn purge --query e0e9c9fc-a8c6-4c60-b9c7-6118a8d44698

          返回示例:

          task 1
              url: http://my.domain.com/to/path/ , type: directory 
              status:      completed
              createdAt:   2017-08-10T03:02:28Z
              startedAt:   None
              finishedAt:  2017-08-10T03:03:11Z
              progress:    100
          参数 说明
          url purge任务的URL和类型
          status in-progress / completed / failed
          createdAt purge任务的创建时间
          startedAt purge任务开始执行的时间
          finishedAt purge任务的结束时间,结束可能是Completed/Failed。如果任务未结束,则不返回该项
          progress 进度百分比

          预加载管理

          预加载缓存

          描述: 用于通知CDN提前缓存指定的URL,支持批量提交,一次最多提交100个url,用户24小时之内最多提交20000个URL。

          命令格式: bce cdn prefetch [--url] [--bos --domain] [--file] <url> <bos:/<bucket-name>/[prefix], domain> <file> [--batch] <batch>

          说明

          • --url:提交单个url预加载请求
          • --bos:提交bos bucket中的预加载请求
          • --file:提交文件中的预加载请求,文件中每个url占一行
          • --batch:在一次性提交多个url时,每批最多上传的url个数,默认为10,最大为100

          操作示例:

          • 提交单个url预加载请求

            		bce cdn prefetch --url http://my.domain.com/1.jpg
          • 提交bos bucket中的预加载请求

            		bce cdn prefetch --bos bos:/fcc-test/ --domain my.domain.com 
          • 提交文件中的预加载请求

            		bce cdn prefetch --file list.txt
          • 指定每批最大提交个数

              bce cdn prefetch --file list.txt --batch 10

          返回示例: prefetch ['http://my.domain.com/1.jpg', 'http://my.domain.com/2.jpg'] ok, id: eJyzMLc0NDUx1bEA02YAGQYDHA==

          查询预加载状态

          描述: 查询预加载请求状态。

          命令格式: bce cdn prefetch --query <prefetch-id>

          说明:

          prefetch-id 为之前提交刷新缓存任务后返回的Id

          操作示例: bce cdn prefetch --query eJyzMLc0NDUx1bEA02YAGQYDHA==

          返回示例:

          task 1
              url: http://my.domain.com/2.jpg 
              status:      failed
              createdAt:   2017-08-10T03:26:31Z
              startedAt:   2017-08-10T03:26:31Z
              finishedAt:  None
              progress:    100
          task 2
              url: http://my.domain.com/1.jpg 
              status:      failed
              createdAt:   2017-08-10T03:26:31Z
              startedAt:   2017-08-10T03:26:31Z
              finishedAt:  None
              progress:    100
          参数 说明
          url prefetch任务的URL和类型
          status waiting / in-progress / completed / failed
          createdAt prefetch任务的创建时间
          startedAt prefetch任务开始执行的时间
          finishedAt prefetch任务的结束时间,结束可能是Completed/Failed。如果任务未结束,则不返回该项
          progress 进度百分比
          上一篇
          配置BCE-CLI
          下一篇
          版本变更记录