华为云用户手册

请求消息 请求参数 请求参数如表1所示。 表1 请求参数 名称 是否必选 参数类型 描述 start_time 否 Long 查询起始时间戳（单位：毫秒）。 end_time 否 Long 查询结束时间戳（单位：毫秒），必须与起始时间戳同时传或不传。 domain_name 是 String 域名列表， 多个域名 以逗号（半角）分隔，如：www.test1.com,www.test2.com ，ALL表示查询名下全部域名 stat_type 是 String 参数类型支持：flux(流量)，bw(带宽)，req_num(请求总数) region 是 String 区域列表，包括：中国34个省级行政区域（包含中国大陆省份、直辖市及港澳台）、中国以外及其他，多个区域以逗号分隔，如：beijing,neimenggu,........ 说明： 传参时区域名称，如“北京、上海、港澳台”等均需用汉语拼音（beijing、shanghai、gangaotai），“中国以外”请用“haiwai”传参。 “山西、陕西”传参时分别用：“shanxi、shaanxi”。 ALL表示查询全部区域。 carrier 是 String 运营商列表，英文首字母缩写，目前支持CTCC（电信）, CMCC（移动）, CUCC（联通）, ENET（教育）, CRC（铁通）。多个运营商以逗号分隔，如：CTCC,CMCC,........ ALL表示查询全部运营商。 region与carrier不能同时传ALL。 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。 请求示例 请求路径示例 GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/region-carrier-domain?start_time=1511366400000&end_time=1511452799640&domain_name=www.test1.com&stat_type=req_num®ion=beijing,neimenggu&carrier=CMCC&enterprise_project_id=0

响应消息 响应参数 响应参数如表2所示。 表2 响应参数 名称 参数类型 描述 flux_detail Object 详情数据对象。详细说明见表3。 flux_detail参数说明 flux_detail参数说明如表3所示。 表3 flux_detail参数说明 名称 参数类型 描述 interval Interger 采样间隔，单位：秒，取值说明： 时间跨度1天：5分钟、1小时、4小时、8小时，分别对应300秒、3600秒、14400秒和28800秒。 时间跨度2~7天：1小时、4小时、8小时、1天，分别对应3600秒、14400秒、28800秒和86400秒。 时间跨度8~31天：4小时、8小时、1天，分别对应14400秒、28800秒和86400秒。 如果不传，默认取对应时间跨度的最小间隔。 start_time Interger 查询起始时间戳（单位：毫秒）。 end_time Interger 查询结束时间戳（单位：毫秒）。 stat_type String 统计类型。 values Array of integers 流量数据列表，从start_time开始，每采样间隔生成一个采样点，按时间顺序排列（单位：Byte）。 响应示例 { "flux_detail": { "interval": 300, "values": [835038583,835038584], "start_time": 1534176000000, "end_time": 1534258800000, "stat_type" : "flux" } }

请求消息 请求参数 请求参数如表1所示。 表1 请求参数 名称 是否必选 参数类型 描述 start_time 否 Long 查询起始时间戳（单位：毫秒）。 end_time 否 Long 查询结束时间戳（单位：毫秒）。 domain_name 是 String 域名列表，多个域名以逗号（半角）分隔，如：www.test1.com，www.test2.com ，ALL表示查询名下全部域名。 interval 否 Integer 采样间隔，单位：秒，取值说明： 时间跨度1天：5分钟、1小时、4小时、8小时。 时间跨度2~7天：5分钟、1小时、4小时、8小时、1天。 时间跨度8~31天：4小时、8小时、1天。 如果不传，默认取对应时间跨度的最小间隔。 如果需要传，则换算成秒。 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。 请求示例 请求路径示例 GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/flux-detail?start_time=1534176000000&end_time=1534258800000&domain_name=www.example.com&interval=300&enterprise_project_id=0

URI PUT /v1.0/cdn/domains/{domain_id}/follow302-switch 表1 路径参数 参数 是否必选 参数类型 描述 domain_id 是 String 加速域名id。 表2 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示修改当前企业项目下加速域名的配置，"all"代表所有项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 follow_status Follow302StatusBody object 回源跟随对象。 表6 Follow302StatusBody 参数 参数类型 描述 domain_id String 加速域名id。 follow_status String follow302状态，off：关闭，on：开启。 枚举值： off on

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表4 请求Body参数 参数 是否必选 参数类型 描述 follow302_status 是 String follow302状态，off：关闭，on：开启。 枚举值： off on

响应示例 状态码： 200 OK { "cache_config" : { "rules" : [ { "rule_type" : 1, "content" : ".jpg;.png", "ttl" : 30, "ttl_type" : 3, "priority" : 1 }, { "rule_type" : 0, "content" : "", "ttl" : 600, "ttl_type" : 1, "priority" : 1 } ], "ignore_url_parameter" : false, "follow_origin" : false, "compress" : { "compress_switch" : 1, "compress_rules" : [ { "compress_type" : "gzip", "compress_file_type" : ".js|.html|.css|.xml|.json|.shtml|.htm" } ] } } }

响应参数 状态码： 200 表8 响应Body参数 参数 参数类型 描述 cache_config CacheConfig object 缓存配置。 表9 CacheConfig 参数 参数类型 描述 ignore_url_parameter Boolean 是否忽略url中的参数。 follow_origin Boolean 缓存规则是否遵循源站。 compress CompressResponse object GZIP压缩. rules Array of Rules objects 缓存规则，将覆盖之前的规则配置。规则为空重置为默认规则。 数组长度：1 - 20 表10 CompressResponse 参数 参数类型 描述 compress_switch Integer GZIP压缩开关。0关闭。1打开 compress_rules Array of CompressRules objects GZIP压缩规则 表11 CompressRules 参数 参数类型 描述 compress_type String GZIP压缩类型（目前只支持 gzip） compress_file_type String GZIP压缩文件类型（文件后缀竖线分割，如：.js|.html|.css|.xml） 表12 Rules 参数 参数类型 描述 rule_type Integer 0：全部类型，表示匹配所有文件，默认值。 1：文件类型，表示按文件后缀匹配。 2：文件夹类型，表示按目录匹配。 3：文件全路径类型，表示按文件全路径匹配，5：缓存首页。 content String 缓存匹配设置。 当rule_type为0时，为空。 当rule_type为1时，为文件后缀，输入首字符为“.”，以“;”进行分隔，如.jpg;.zip;.exe，并且输入的文件名后缀总数不超过20个。 当rule_type为2时，为目录，输入要求以“/”作为首字符，以“;”进行分隔，如/test/folder01;/test/folder02，并且输入的目录路径总数不超过20个。 当rule_type为3时，为全路径，输入要求以“/”作为首字符，支持匹配指定目录下的具体文件，或者带通配符“*”的文件，如/test/index.html或/test/*.jpg。 ttl Integer 缓存时间。最大支持365天。 ttl_type Integer 缓存时间单位。1：秒；2：分；3：小时；4：天。 priority Integer 此条配置的优先级, 默认值1，数值越大，优先级越高。取值范围为1-100，优先级不能相同。

请求示例 PUT https://cdn.myhuaweicloud.com/v1.0/cdn/domains/ff808***********************2d71/cache?enterprise_project_id=0 { "cache_config" : { "ignore_url_parameter" : false, "follow_origin" : false, "compress" : { "compress_switch" : 1 }, "rules" : [ { "rule_type" : 1, "content" : ".jpg;.png", "ttl" : 30, "ttl_type" : 3, "priority" : 1 } ] } }

URI PUT /v1.0/cdn/domains/{domain_id}/cache 表1 路径参数 参数 是否必选 参数类型 描述 domain_id 是 String 加速域名ID。 表2 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示修改当前企业项目下加速域名的配置，"all"代表所有项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表4 请求Body参数 参数 是否必选 参数类型 描述 cache_config 是 CacheConfigRequest object 缓存配置。 表5 CacheConfigRequest 参数 是否必选 参数类型 描述 ignore_url_parameter 否 Boolean 是否忽略url中的参数。 follow_origin 否 Boolean 缓存规则是否遵循源站。 compress 否 CompressRequest object GZIP压缩 rules 否 Array of Rules objects 缓存规则，将覆盖之前的规则配置。规则为空重置为默认规则。 数组长度：1 - 20 表6 CompressRequest 参数 是否必选 参数类型 描述 compress_switch 否 Integer GZIP压缩开关，0：关闭，1：打开。 表7 Rules 参数 是否必选 参数类型 描述 rule_type 是 Integer 0：全部类型，表示匹配所有文件，默认值。 1：文件类型，表示按文件后缀匹配。 2：文件夹类型，表示按目录匹配。 3：文件全路径类型，表示按文件全路径匹配，5：缓存首页。 content 否 String 缓存匹配设置。 当rule_type为0时，为空。 当rule_type为1时，为文件后缀，输入首字符为“.”，以“;”进行分隔，如.jpg;.zip;.exe，并且输入的文件名后缀总数不超过20个。 当rule_type为2时，为目录，输入要求以“/”作为首字符，以“;”进行分隔，如/test/folder01;/test/folder02，并且输入的目录路径总数不超过20个。 当rule_type为3时，为全路径，输入要求以“/”作为首字符，支持匹配指定目录下的具体文件，或者带通配符“*”的文件，如/test/index.html或/test/*.jpg。 ttl 是 Integer 缓存时间。最大支持365天。 ttl_type 是 Integer 缓存时间单位。1：秒；2：分；3：小时；4：天。 priority 是 Integer 此条配置的优先级, 默认值1，数值越大，优先级越高。取值范围为1-100，优先级不能相同。

请求示例 PUT https://cdn.myhuaweicloud.com/v1.0/cdn/domains/ff808**********************2d71/origin?enterprise_project_id=0 { "origin" : { "sources" : [ { "ip_or_domain" : "0.0.0.0", "origin_type" : "ipaddr", "active_standby" : 1, "http_port" : 80, "https_port" : 443 } ] } }

响应示例 状态码： 200 OK { "origin" : { "sources" : [ { "domain_id" : "12ab***********************02b71", "origin_type" : "ipaddr", "ip_or_domain" : "0.0.0.0", "active_standby" : 1, "http_port" : 80, "https_port" : 443 } ] } }

响应参数 状态码： 200 表7 响应Body参数 参数 参数类型 描述 origin ResourceBody object 源站对象。 表8 ResourceBody 参数 参数类型 描述 sources Array of SourceWithPort objects 源站配置。 表9 SourceWithPort 参数 参数类型 描述 domain_id String 加速域名id。 ip_or_domain String 源站IP（非内网IP）或者域名。 origin_type String 源站类型，ipaddr：源站IP、 domain：源站域名、obs_bucket：OBS桶域名。 枚举值： ipaddr domain obs_bucket active_standby Integer 主备状态（1代表主源站；0代表备源站）。 enable_obs_web_hosting Integer 是否开启Obs静态网站托管(0表示关闭,1表示则为开启)，源站类型为obs_bucket时传递。 http_port Integer HTTP端口，默认80 https_port Integer HTTPS端口，默认443

URI PUT /v1.0/cdn/domains/{domain_id}/origin 表1 路径参数 参数 是否必选 参数类型 描述 domain_id 是 String 加速域名ID。 表2 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示修改当前企业项目下加速域名的配置，"all"代表所有项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表4 请求Body参数 参数 是否必选 参数类型 描述 origin 是 ResourceBody object 源站对象。 表5 ResourceBody 参数 是否必选 参数类型 描述 sources 是 Array of SourceWithPort objects 源站配置。 表6 SourceWithPort 参数 是否必选 参数类型 描述 domain_id 否 String 加速域名id。 ip_or_domain 是 String 源站IP（非内网IP）或者域名。 origin_type 是 String 源站类型，ipaddr：源站IP、 domain：源站域名、obs_bucket：OBS桶域名。 枚举值： ipaddr domain obs_bucket active_standby 是 Integer 主备状态（1代表主源站；0代表备源站）。 enable_obs_web_hosting 否 Integer 是否开启Obs静态网站托管(0表示关闭,1表示则为开启)，源站类型为obs_bucket时传递。 http_port 否 Integer HTTP端口，默认80 https_port 否 Integer HTTPS端口，默认443

错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 200 CDN.0005 The upper limit is exceeded. 超出最大限制。 请按配额合理规划操作，或提工单申请扩大配额。 200 CDN.0015 Service area not supported. 不支持当前服务范围。 / 200 CDN.0016 This service type is not supported. 不支持的业务类型。 请输入正确的业务类型。 200 CDN.0101 The acceleration domain name already exists. 加速域名已经添加。 请提交工单处理。 200 CDN.0102 The domain name has not been filed or the filing has expired. 加速域名审核失败。 请在工信部为加速域名备案。 200 CDN.0103 Information about the origin server format is incorrect. 源站审核失败。 请在工信部为源站域备案。 200 CDN.0104 The number of acceleration domain names has reached the upper limit. 加速域名已达到上限。 请提交工单申请扩大域名配额。 200 CDN.0105 The acceleration domain name does not exist. 加速域名不存在。 请确认操作域名是否正确，如确认正确请提交工单处理。 200 CDN.0106 This operation is not supported by the domain name in the current state. 当前域名状态无法操作。 请检查域名是否被封禁、锁定或域名状态是否支持当前操作（如：未在启用状态下的域名不可执行停用操作）。 200 CDN.0107 The retrieval host failed the audit. 回源host审核失败。 请在工信部为回源host域名备案。 200 CDN.0108 The URL domain name is not the acceleration domain name of the current tenant. 域名不属于当前租户。 请确认操作域名是否正确，如确认正确请提交工单处理。 200 CDN.0109 The domain name of the origin server must be different from the acceleration domain name. 源站域名不能与加速域名相同。 源站域名不能与加速域名相同，需要调整加速域名。 200 CDN.0110 The number of URLs to be preheated or refreshed exceeds the upper limit. URL数超出预热刷新限制。 请提交工单申请扩大刷新预热配额。 200 CDN.0114 The billing mode has not been configured. CDN服务未开通。 请前往CDN服务界面选择计费模式并开通CDN服务。 200 CDN.0115 Acceleration domain names are prohibited. 域名已被封禁。 请提交工单申请解封。 200 CDN.0116 Acceleration domain names are locked. 域名已被锁定。 请提交工单申请取消锁定。 200 CDN.0117 If the retrieval host is set to an origin server domain name, the origin server cannot be an IP address. 源站域名为回源HOST，源站不能为IP地址形式。 请修改源站接入形式。 200 CDN.0120 The domain name has been added by another user. 域名已被其他用户添加。 请提交工单处理。 200 CDN.0121 The IP address must not be an internal network IP address. 输入的IP不能是内网IP。 IP不能是内网IP地址，请检查填写的IP地址类型。 200 CDN.0126 Only domain names that are disabled or fail to be configured, audited, or synchronized can be deleted. 仅停用，配置失败，审核失败，同步失败的域名才可进行删除操作。 请检查域名状态是否为停用、配置失败、审核失败或同步失败，其他状态无法删除。 200 CDN.0127 The domain name format is incorrect. 域名格式错误。 请填写正确格式的域名。 200 CDN.0128 The service type is incorrect. 业务类型错误。 请根据接口文档填写正确的业务类型。 200 CDN.0129 The origin type is incorrect. 源站类型错误。 请根据接口文档填写正确的源站类型。 200 CDN.0130 The number of origin server IP addresses exceeds the upper limit. 源站IP个数超出限制。 请检查输入的IP是否超出数量限制。 200 CDN.0131 The number of origin server domain names exceeds the upper limit. 源站域名个数超出限制。 请检查输入的源站域名个数是否超出数量限制。 200 CDN.0132 The retrieval host type is incorrect. 回源Host类型错误 请根据接口文档填写正确的回源host类型 200 CDN.0133 The retrieval host is incorrect. 回源host错误。 请根据接口文档填写正确格式的回源host。 200 CDN.0134 The weight of cache rules must be an integer from 1 to 100. 缓存规则的权重应为1到100之间的整数。 请输入1-100的整数。 200 CDN.0135 The cache rule type is incorrect. 缓存规则类型错误。 请根据接口文档查看CDN支持的缓存规则类型。 200 CDN.0136 The time range must fall within 0 to 365 days. 时间范围必须在0到365天内。 请输入0-365天。 200 CDN.0137 The cache rule format is invalid. 缓存过期规则设置格式不合法。 请根据接口文档查看CDN支持的缓存规则格式。 200 CDN.0138 The anti-leeching URL type is incorrect. 防盗链类型错误。 请根据接口文档填写CDN支持的防盗链类型。 200 CDN.0139 The number of anti-leeching domain names must range from 1 to 100. 防盗链域名数量必须在1~100之间。 请输入1-100个防盗链域名。 200 CDN.0141 The domain name is not filed with the Ministry of Industry and Information Technology of the People's Republic of China. 域名未备案。 加速域名未备案。 200 CDN.0142 Https not support yet. 不支持https协议。 / 200 CDN.0143 The ownership of the domain name is not verified. 泛域名所有权未验证。 请检查创建的泛域名是否与已有域名冲突或提交工单联系运维处理。 200 CDN.0145 Only domain names in the Enabled state and that are not banned or locked in the background support this operation. 只有处于已开启状态的域名才可执行此操作。 请检查域名是否处于启用状态。 200 CDN.0147 The origin is an OBS domain name. Retrieval host cannot be modified. OBS桶做为源站，不能修改回源host。 / 200 CDN.0148 The origin is an OBS domain name. Standby origin cannot be configured. OBS桶做源站，不能添加备源站。 / 200 CDN.0149 Not allowed because the domain name is in a shared cache group. 不支持删除共享缓存组主域名。 / 200 CDN.0156 ****, source is illegal. 源站无效 更换有效源站。 200 CDN.0163 The domain has special config. Please contact CDN operators to change. 域名有特殊配置。 请联系CDN管理员修改。 200 CDN.0201 Domain name error. 域名错误。 加速域名无效或不存在，请刷新页面检查域名是否在域名列表中，如果仍有问题，请提交工单处理。 200 CDN.0202 Statistical time error. 统计时间错误。 请按接口文档检查统计开始时间、结束时间是否正确，如查询范围超限、开始时间大于结束时间、时间为负数等。 200 CDN.0203 Sampling interval error. 采样间隔错误。 请检查采样间隔是否与时间跨度匹配。 200 CDN.0401 Certificates are deleted mistakenly. 证书删除错误。 请提交工单处理。 200 CDN.0402 The certificate or private key cannot be left blank. 证书或私钥不能为空。 请检查是否输入了证书或私钥。 200 CDN.0403 The certificate must be in the PEM format. 证书格式需要为pem。 请检查证书格式是否为PEM格式。 200 CDN.0404 The private key format must be in the PEM format. 私钥格式需要为pem。 请检查私钥格式是否为PEM格式。 200 CDN.0405 The certificate and private key do not match. 证书与私钥不匹配。 请检查证书是否与私钥配对。 200 CDN.0406 The certificate and domain name do not match. 证书与域名不匹配。 请检查证书是否与加速域名配对。 200 CDN.0407 Certificate error. 证书错误。 请提交工单处理。 200 CDN.0408 The certificate has expired. 证书已过期。 请更新证书链中的证书。 200 CDN.0409 The certificate will expire in less than 24 hours. 证书剩余有效期不足24小时。 请更新证书链中的证书。 200 CDN.0410 The certificate chain cannot be supplemented. 证书链无法补齐。 请补齐证书链。 200 CDN.0411 The certificate status is incorrect. 证书状态不正确。 请提交工单处理。 200 CDN.0412 The length of the certificate or private key content exceeds the upper limit. 证书或私钥内容长度超出限制。 请查看CDN资料查看证书支持长度。 200 CDN.0413 The certificate not yet valid. 证书还未生效。 请提交工单处理。 200 CDN.0414 Invalid private key format of the certificate. Only RSA format is supported. 证书私钥错误。 请提交工单处理。 400 CDN.0001 Parameter error. 参数格式错误（格式错误或者缺失参数）。 请根据接口文档核对并纠正错误参数。 400 CDN.00010177 Failed to add a domain name whose service area covers Chinese mainland because your account has not completed real-name authentication. 账号未实名认证。 实名认证后重新添加。 400 CDN.00010178 Domain name restricted. Submit a service ticket. 待添加的域名受限。 请提交工单处理。 400 CDN.00010179 Wildcard domain names cannot be added as origin servers. 源站错误。 不支持泛域名作为源站，请更换源站域名后重新添加。 400 CDN.00010180 The origin server cannot be a subdomain of a wildcard domain. 源站错误。 您已添加泛域名作为加速域名，不可用该泛域名的子域名作为源站，请更换源站域名后重新添加。 400 CDN.00010183 Not allowed because the domain name has shared settings. 不支持删除共享配置组主域名。 / 400 CDN.00010185 Domain owner verify failed. 域名归属验证失败。 / 401 CDN.0002 Unauthenticated user. 用户未鉴权。 请携带正确的鉴权信息。 403 CDN.00010181 No enterprise projects available. 错误的企业项目。 请确认当前账号是否已开通企业项目。 403 CDN.00010182 Resource does not belong to this enterprise project. 域名不在当前企业项目中。 请确认域名归属的企业项目后重新执行该操作。 403 CDN.0004 Insufficient permission. 用户权限不足。 请检查是否拥有操作权限。如没有，请获取相应操作权限；如有，请提交工单处理。 403 CDN.0019 Operation not allowed. 不支持当前操作。 / 403 CDN.0020 The user is not authorized to the enterprise project. 对应用户无该企业项目授权。 请先获取企业项目授权。 403 CDN.0021 The user does not have operation permissions because the fine-grained authentication is not passed. 对应用户细粒度鉴权不通过，无操作权限。 请先获取细粒度鉴权。 404 CDN.0003 The object does not exist. 对象不存在。 请确定操作的对象存在。 500 CDN.0000 System error. 系统内部错误。 请提交工单处理。 父主题： 附录

请求示例 GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/statistics-excel？start_time=1667030400000&end_time_1667116800000&domain_name=www.test1.com&excel_language=zh&service_area=mainland_china&interval=300&enterprise_project_id=all&excel_type=excel_type_usage

功能介绍 下载统计指标数据表格文件。 支持下载90天内的指标数据。 时间跨度不能超过31天。 起始时间和结束时间，左闭右开。如时间跨度为2022-10-24 00:00:00 到 2022-10-25 00:00:00，表示取 [2022-10-24 00:00:00, 2022-10-25 00:00:00)的统计数据。 起始时间、结束时间必须传毫秒级时间戳，起始时间和结束时间必须同时指定。 单租户调用频率：10次/min。

URI GET /v1.0/cdn/statistics/statistics-excel 表1 Query参数 参数 是否必选 参数类型 描述 start_time 是 Long 查询起始时间戳，时间戳应设置需为整5分钟，设置方式如下： interval为300时，start_time设置为整5分钟时刻点，如：1631240100000(对应2021-09-10 10:15:00) interval为3600时，start_time设置为整小时时刻点，如：1631239200000(对应2021-09-10 10:00:00) interval为86400时，start_time设置为东8区零点时刻点，如：1631203200000(对应2021-09-10 00:00:00) end_time 是 Long 查询结束时间戳，时间戳应设置需为整5分钟，设置方式如下： interval为300时，end_time设置为整5分钟时刻点，如：1631243700000(对应2021-09-10 11:15:00) interval为3600时，end_time设置为整小时时刻点，如：1631325600000(对应2021-09-11 10:00:00) interval为86400时，end_time设置为东8区零点时刻点，如：1631376000000(对应2021-09-12 00:00:00) domain_name 是 String 域名列表，多个域名以逗号（半角）分隔，如：www.test1.com,www.test2.com all表示查询名下全部域名 excel_language 否 String 创建表格语言，支持zh(中文)，en(英文)两种，如果不传默认为zh service_area 否 String 服务区域：mainland_china（默认）、outside_mainland_china，当查询回源类指标时该参数无效。 interval 否 Long 查询时间间隔，单位：秒，取值说明： 300(5分钟)：最大查询跨度2天 3600(1小时)：最大查询跨度7天 86400(1天)：最大查询跨度31天 如果不传，默认取对应时间跨度的最小间隔。 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。 excel_type 是 String 统计数据表格类型,目前支持 用量统计数据(excel_type_usage) 访问情况统计数据(excel_type_access) 回源情况统计数据（excel_type_origin） http_code统计数据(excel_type_http_code)

响应消息 响应参数 响应参数如表2所示。 表2 响应参数 名称 参数类型 描述 domain_summary_detail Object 详情数据对象。详细说明见表3。 domain_summary_detail参数说明 domain_summary_detail参数说明如表3所示。 表3 domain_summary_detail参数说明 名称 参数类型 描述 start_time Integer 查询起始时间戳（单位：毫秒）。 end_time Integer 查询结束时间戳（单位：毫秒）。 interval Integer 采样间隔，单位：秒。 values Array of integers 从start_time开始，每采样间隔生成一个采样点，按时间顺序排列，每个采样点数据类型为long。（流量单位：Byte，带宽单位：bps） stat_type String 统计类型。 service_area String mainland_china(中国大陆)，outside_mainland_china(中国大陆境外)。回源指标不区分服务范围，该参数对回源指标无效。 响应示例 { "domain_summary_detail": { "interval": 300, "values": [835038583,835038584], "start_time": 1498838400000, "end_time": 1502380500000, "stat_type": "bs_flux", "service_area": "outside_example_china" } }

请求消息 请求参数 请求参数如表1所示。 表1 请求参数 名称 是否必选 参数类型 描述 start_time 否 Long 查询起始时间戳（单位：毫秒）。 end_time 否 Long 查询结束时间戳（单位：毫秒）。 domain_name 是 String 域名列表，多个域名以逗号（半角）分隔，如：www.test1.com，www.test2.com ，ALL表示查询名下全部域名。单次最多可查询100个。 interval 否 Integer 采样间隔，单位：秒，取值说明： 时间跨度1天：5分钟、1小时、4小时、8小时，分别对应300秒、3600秒、14400秒和28800秒。 时间跨度2~7天：5分钟、1小时、4小时、8小时、1天，分别对应300秒、3600秒、14400秒、28800秒和86400秒。 时间跨度8~31天：4小时、8小时、1天，分别对应14400秒、28800秒和86400秒。 如果不传，默认取对应时间跨度的最小间隔。 stat_type 是 String 参数类型支持：bw（带宽），flux（流量），bs_bw(回源带宽)，bs_flux（回源流量），bs_num(回源总数)，bs_fail_num(回源失败总数)，req_num(请求总数)，req_hit_rate（请求命中率），flux_hit_rate（流量命中率），bs_fail_rate（回源失败率），qps（每秒请求数），http_code_2xx(状态码2xx)，http_code_3xx(状态码3xx)，http_code_4xx(状态码4xx)，http_code_5xx(状态码5xx)。 service_area 否 String mainland_china(中国大陆)，outside_mainland_china(中国大陆境外)，默认为mainland_china,回源指标bs_flux，bs_bw，bs_fail_rate,回源指标不区分服务范围，该参数对回源指标无效。 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。 请求示例 请求路径示例 GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/domain-summary-detail?start_time=1498838400000&end_time=1502380500000&domain_name=www.example.com&interval=300&stat_type=bs_flux&enterprise_project_id=0

URI GET /v1.0/cdn/domains/{domain_id}/referer 表1 路径参数 参数 是否必选 参数类型 描述 domain_id 是 String 加速域名ID。 表2 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 referer RefererRsp object Referrer配置。 表5 RefererRsp 参数 参数类型 描述 referer_type Integer Referer类型。取值：0代表不设置Referer过滤；1代表黑名单；2代表白名单。默认取值为0。 referer_list String 配置的referer地址。 include_empty Boolean 是否包含空Referer。如果是黑名单并开启该选项，则表示无referer不允许访问。如果是白名单并开启该选项，则表示无referer允许访问。默认不包含,true：包含，false：不包含。

请求消息 请求参数 请求参数如表2所示。 表2 请求参数 名称 是否必须 参数类型 描述 urls 是 Array of strings 输入示例：http://abc.com/image/1.png，多个URL之间需要用逗号分隔，目前不支持对目录的预热，单个url的长度限制为10240字符,单次最多输入1000个url。 请求示例 请求路径示例 POST https://cdn.myhuaweicloud.com/v1.0/cdn/preheatingtasks?enterprise_project_id=0 { "preheatingTask":{ "urls":[ "http://www.example1.com/index.html", "http://www.example2.com/web" ] } }

响应消息 响应参数 响应参数如表3所示。 表3 响应参数 名称 参数类型 描述 id String 任务id。 task_type String 任务的类型， 其值可以为refresh| preheating。 status String 预热结果。task_done表示预热成功 ，task_inprocess表示预热中。 processing Integer 处理中的url个数。 succeed Integer 成功处理的url个数。 failed Integer 处理失败的url个数。 total Integer 总共的任务个数。 create_time Integer 任务创建时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。 urls Array of strings 预热的url。 响应示例 { "preheatingTask" : { "id" : "ff8080*********************c6e", "status" : "task_inprocess", "processing" : 2, "succeed" : 0, "failed" : 0, "urls" : [ "http://www.example1.com/index.html", "http://www.example2.com/web" ], "task_type" : "preheating", "total" : 2, "create_time" : 0 } }

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表4 请求Body参数 参数 是否必选 参数类型 描述 headers 否 HeaderMap object 设置HTTP头参数的值。 表5 HeaderMap 参数 是否必选 参数类型 描述 Content-Disposition 否 String 指示回复的内容该以何种形式展示 Content-Language 否 String 说明访问者希望采用的语言或语言组合 Access-Control-Allow-Origin 否 String 指定了该响应的资源是否被允许与给定的origin共享 Access-Control-Allow-Methods 否 String 明确了客户端所要访问的资源允许使用的方法或方法列表 Access-Control-Max-Age 否 String Access-Control-Allow-Methods 和Access-Control-Allow-Headers 提供的信息可以被缓存多久 Access-Control-Expose-Headers 否 String 列出了哪些首部可以作为响应的一部分暴露给外部

请求示例 PUT https://cdn.myhuaweicloud.com/v1.0/cdn/domains/ff808***********************307d/response-header { "headers" : { "Content-Disposition" : "test.xml", "Content-Language" : "en-US", "Access-Control-Max-Age" : "86400" } }

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 headers HeaderMap object HTTP头值。 表7 HeaderMap 参数 参数类型 描述 Content-Disposition String 指示回复的内容该以何种形式展示 Content-Language String 说明访问者希望采用的语言或语言组合 Access-Control-Allow-Origin String 指定了该响应的资源是否被允许与给定的origin共享 Access-Control-Allow-Methods String 明确了客户端所要访问的资源允许使用的方法或方法列表 Access-Control-Max-Age String Access-Control-Allow-Methods 和Access-Control-Allow-Headers 提供的信息可以被缓存多久 Access-Control-Expose-Headers String 列出了哪些首部可以作为响应的一部分暴露给外部

URI PUT /v1.0/cdn/domains/{domain_id}/response-header 表1 路径参数 参数 是否必选 参数类型 描述 domain_id 是 String 加速域名ID。 表2 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示修改当前企业项目下加速域名的配置，"all"代表所有项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。