命令行工具 CLI：CDN 命令介绍

下面文档将通过命令说明和使用示范进行 CDN 命令的展示。

类型一：服务操作命令


OpenCdnService
命令说明：
用于开通 CDN 服务。只有开通后，才能进行域名操作，一个用户只能开通一次。开通条件：帐号已通过实名认证。
使用示范：

1. aliyuncli cdn OpenCdnService --InternetChargeType PayByTraffic

DescribeCdnService
命令说明：
用于查询 CDN 服务状态。包括当前计费类型、服务开通时间、下次生效的计费类型、当前业务状态等。
使用示范：

1. aliyuncli cdn DescribeCdnService

ModifyCdnService
命令说明：
用于变更 CDN 服务的计费类型。
使用示范：

1. aliyuncli cdn ModifyCdnService --InternetChargeType PayByTraffic

类型二：域名操作命令


DescribeUserDomains
命令说明：
用于查询用户名下所有的域名与状态。域名状态包括运行中（表示域名服务状态正常）、可以、已停止、配置中、 配置失败。
DescribeCdnDomainDetail
命令说明：
用于获取指定加速域名配置的基本信息。
AddCdnDomain
命令说明：
用于添加加速域名，一次只能提交一个加速域名，一个用户最多添加20个域名。
限制条件：
创建加速域名之前，必须先开通 CDN 服务。加速域名必须已备案完成。源站内容如果不在阿里云平台上，需要审核，审核工作会在下一工作日前完成。
StartCdnDomain
命令说明：
用于启用状态为“停用”的加速域名，将 DomainStatus 变更为 online。注意：域名对应账户如果欠费或域名处于非法状态，则无法正常调用该接口启用加速域名。
StopCdnDomain
命令说明：
用于停用某个加速域名，将 DomainStatus 变更为 offline。
注意：停用该加速域名后，该条加速域名信息仍保留，针对加速域名的请求系统将做自动回源处理。若暂时不需要对某域名进行加速，推荐使用 StopCdnDomain 接口，暂停域名加速效果。
DeleteCdnDomain
命令说明：
用于删除当前加速域名，每次只能提交一个加速域名。DeleteCdnDomain 调用成功后将删除本条加速域名的全部相关记录，若仅需暂停使用该加速域名，推荐使用 StopCdnDomain 接口。
危险：请慎重使用该命令，建议在进行域名删除前到域名解析服务商处恢复域名 A 记录，以免导致删除操作后此域名不可访问。

类型三：刷新预热命令


RefreshObjectCaches
命令说明：
用于刷新节点上的文件内容。刷新制定 URL 内容指 Cache 节点，每次只能提交一个 URL。
限制：同一个 ID 每天最多提交预热刷新类请求数量为—— URL：2000条；目录：100个。
刷新预热类接口包含 RefreshObjectCaches 刷新接口和 PushObjectCache 预热接口。
PushObjectCache
命令说明：
用于将源站的内容主动预热到 L2 Cache 节点上，用户首次访问可直接命中缓存，缓解源站压力。
限制：同一个 ID 每天最多提交刷新预热类请求数量为—— URL：2000条；注意目前不支持目录级别的预热。刷新预热类接口包含  RefreshObjectCaches 刷新接口和 PushObjectCache 预热接口。
DescribeRefreshTasks
命令说明：
用于查询预热刷新状态是否在全网生效。
注意：支持根据任务 ID、URL 查询，若 taskid 与 objectpath 都不指定，默认查 7 天内、第一页的数据（20条）。Taskid 与 objectpath 可以同时指定，但逻辑与关系只可查询 7 天内的数据。

类型四：资源监控命令


DescribeCdnMonitorData
命令说明：
用于获取区域名最小5分钟粒度的监控数据。包括请求命中率、字节命中率、QPS、流量、平均响应时间。
注意：不指定 StartTime 和 EndTime 时，默认读取过去24小时的数据，同时支持按指定的起止时间查询，两者需要同时指定。一次最多1个域名，最多可获取最近30天的数据。

类型五：日志信息命令


DescribeCdnDomainLogs
命令说明：
用于获取指定域名的原始访问日志的下载地址。
注意：日志内容最长保留2周。