华为云用户手册

功能介绍 支持查询90天内的数据。 查询跨度是7天。 最多同时指定100个 域名 。 起始时间和结束时间，左闭右开，需要同时指定。 开始时间、结束时间必须传毫秒级时间戳，且必须为5分钟整时刻点，如：0分、5分、10分、15分等，如果传的不是5分钟时刻点，返回数据可能与预期不一致。 统一用开始时间表示一个时间段，如：2019-01-24 20:15:00 表示取 [20:15:00, 20:20:00)的统计数据，且左闭右开。 流量类指标单位统一为Byte（字节）、带宽类指标单位统一为bit/s（比特/秒）、请求数类指标单位统一为次数。 用于查询指定域名、指定统计指标的明细数据。 如果传的是 多个域名 ，则每个域名的数据分开返回。 支持按区域、运营商维度查询统计数据, 回源指标除外。 支持同时查询多个指标，不超过10个。 域名为海外加速场景不适用。

响应示例 状态码： 200 OK { "domain" : { "sources" : [ { "domain_id" : "ff80808***********************07d", "origin_type" : "ipaddr", "ip_or_domain" : "0.0.0.0", "active_standby" : 1, "http_port" : 80, "https_port" : 443 } ], "cname" : "example1.example2.com.c.example3.com", "id" : "ff80808***********************07d", "user_domain_id" : "6e3********************************441", "domain_name" : "example1.example2.com", "business_type" : "web", "service_area" : "mainland_china", "domain_status" : "deleting", "https_status" : 2, "create_time" : 1532405584521, "modify_time" : 1532406543021, "domain_origin_host" : { "domain_id" : "ff80808***********************07d", "origin_host_type" : "accelerate", "customize_domain" : "example1.example2.com" }, "disabled" : 0, "locked" : 0, "range_status" : "off", "follow_status" : "off", "origin_status" : "on", "auto_refresh_preheat" : 0 } }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 domain DomainsWithPort object 域名信息。 表5 DomainsWithPort 参数 参数类型 描述 id String 加速域名ID。 domain_name String 加速域名。 business_type String 域名业务类型，若为web，则表示类型为网站加速；若为download，则表示业务类型为文件下载加速；若为video，则表示业务类型为点播加速；若为wholeSite，则表示类型为全站加速。 user_domain_id String 域名所属用户的domain_id。 domain_status String 加速域名状态。取值意义： online表示“已开启” offline表示“已停用” configuring表示“配置中” configure_failed表示“配置失败” checking表示“审核中” check_failed表示“审核未通过” deleting表示“删除中”。 cname String 加速域名对应的CNAME。 sources Array of SourceWithPort objects 源站配置。 domain_origin_host DomainOriginHost object 域名回源HOST配置。 https_status Integer 是否开启HTTPS加速。 0：代表未开启HTTPS加速； 1：代表开启HTTPS加速，且回源方式为协议跟随； 2：代表开启HTTPS加速，且回源方式为HTTP； 3：代表开启HTTPS加速，且回源方式为HTTPS。 create_time Long 域名创建时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。 modify_time Long 域名修改时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。 disabled Integer 封禁状态（0代表未禁用；1代表禁用）。 locked Integer 锁定状态（0代表未锁定；1代表锁定）。 auto_refresh_preheat Integer 自动刷新预热（0代表关闭；1代表打开）。 service_area String 华为云CDN提供的加速服务范围，包含：mainland_china中国大陆、outside_mainland_china中国大陆境外、global全球。 range_status String Range回源状态（off代表关闭 on代表开启）。 follow_status String 回源跟随状态（off代表关闭 on代表开启）。 origin_status String 是否暂停源站回源（off代表关闭 on代表开启）。 banned_reason String 域名禁用原因。 1：该域名涉嫌违规内容（涉黄/涉赌/涉毒/涉政）已被禁用； 2：该域名因备案失效已被禁用； 3：该域名遭受攻击，已被禁用； 150：该域名涉嫌违规内容涉黄已被禁用； 151：该域名涉嫌违规内容涉政已被禁用； 152：该域名涉嫌违规内容涉暴已被禁用； 153：该域名涉嫌违规内容涉赌已被禁用。 locked_reason String 域名锁定原因（Changing the config, please wait）。 enterprise_project_id String 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，不传表示查询默认项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。 表6 SourceWithPort 参数 参数类型 描述 domain_id String 加速域名id。 ip_or_domain String 源站IP（非内网IP）或者域名。 origin_type String 源站类型，ipaddr：源站IP、 domain：源站域名、obs_bucket：OBS桶域名。 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 表7 DomainOriginHost 参数 参数类型 描述 domain_id String 域名ID。 origin_host_type String 回源host的类型,accelerate：选择加速域名作为回源host域名， customize：使用自定义的域名作为回源host域名。 customize_domain String 回源host域名。返回加速域名主源站设置的HOST域名，如果加速域名有多个主源站且对应多个回源HOST，则返回源站配置中的第一个主源站对应的HOST域名。

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

响应参数 状态码： 200 表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 列出了哪些首部可以作为响应的一部分暴露给外部

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

响应示例 状态码： 200 OK { "domain_item_details" : { "start_time" : 1515996000000, "end_time" : 1515999600000, "stat_type" : "flux", "domains" : [ { "domain_name" : "www.test1.com", "flux" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ] }, { "domain_name" : "www.test2.com", "flux" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ] } ] } }

功能介绍 支持查询90天内的数据。 查询跨度不能超过7天。 最多同时指定100个域名。 起始时间和结束时间，左闭右开，需要同时指定。 开始时间、结束时间必须传毫秒级时间戳，且必须为5分钟整时刻点，如：0分、5分、10分、15分等，如果传的不是5分钟时刻点，返回数据可能与预期不一致。 统一用开始时间表示一个时间段，如：2019-01-24 20:15:00 表示取 [20:15:00, 20:20:00)的统计数据，且左闭右开。 流量类指标单位统一为Byte（字节）、带宽类指标单位统一为bit/s（比特/秒）、请求数类指标单位统一为次数。用于查询指定域名、指定统计指标的明细数据。 如果传的是多个域名，则每个域名的数据分开返回。 支持同时查询多个指标，不超过10个。

URI GET /v1.0/cdn/statistics/domain-item-details 表1 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。 start_time 是 Long 查询起始时间戳，必须设为5分钟整时刻点 end_time 是 Long 查询结束时间戳，必须设为5分钟整时刻点 domain_name 是 String 域名列表，多个域名以逗号（半角）分隔，如：www.test1.com,www.test2.com，all表示查询名下全部域名 service_area 否 String mainland_china(中国大陆)，outside_mainland_china(中国大陆境外)，默认为mainland_china。 stat_type 是 String 网络资源消耗： bw（带宽） flux（流量） bs_bw(回源带宽) bs_flux（回源流量） 访问情况： req_num（请求总数） hit_num（请求命中次数） bs_num(回源总数) bs_fail_num(回源失败数) hit_flux（命中流量） HTTP状态码（组合指标）： http_code_2xx(状态码汇总2xx) http_code_3xx(状态码汇总3xx) http_code_4xx(状态码汇总4xx) http_code_5xx(状态码汇总5xx) bs_http_code_2xx（回源状态码汇总2xx） bs_http_code_3xx（回源状态码汇总3xx） bs_http_code_4xx（回源状态码汇总4xx） bs_http_code_5xx（回源状态码汇总5xx） status_code_2xx（状态码详情2xx） status_code_3xx（状态码详情3xx） status_code_4xx（状态码详情4xx） status_code_5xx（状态码详情5xx） bs_status_code_2xx（回源状态码详情2xx） bs_status_code_3xx（回源状态码详情3xx） bs_status_code_4xx（回源状态码详情4xx） bs_status_code_5xx（回源状态码详情5xx） status_code和bs_status_code不能一起查询，否则数据会不准确，status_code不支持指定服务区域

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 domain DomainsWithPort object 域名信息 表5 DomainsWithPort 参数 参数类型 描述 id String 加速域名ID。 domain_name String 加速域名。 business_type String 域名业务类型，若为web，则表示类型为网站加速；若为download，则表示业务类型为文件下载加速；若为video，则表示业务类型为点播加速；若为wholeSite，则表示类型为全站加速。 user_domain_id String 域名所属用户的domain_id。 domain_status String 加速域名状态。取值意义： online表示“已开启” offline表示“已停用” configuring表示“配置中” configure_failed表示“配置失败” checking表示“审核中” check_failed表示“审核未通过” deleting表示“删除中”。 cname String 加速域名对应的CNAME。 sources Array of SourceWithPort objects 源站域名或源站IP，源站为IP类型时，仅支持IPv4，如需传入多个源站IP，以多个源站对象传入，除IP其他参数请保持一致，主源站最多支持15个源站IP对象，备源站最多支持15个源站IP对象；源站为域名类型时仅支持1个源站对象。不支持IP源站和域名源站混用。 domain_origin_host DomainOriginHost object 域名回源设置信息 https_status Integer 是否开启HTTPS加速。 0：代表未开启HTTPS加速； 1：代表开启HTTPS加速，且回源方式为协议跟随； 2：代表开启HTTPS加速，且回源方式为HTTP； 3：代表开启HTTPS加速，且回源方式为HTTPS。 create_time Long 域名创建时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。 modify_time Long 域名修改时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。 disabled Integer 封禁状态（0代表未禁用；1代表禁用）。 locked Integer 锁定状态（0代表未锁定；1代表锁定）。 auto_refresh_preheat Integer 自动刷新预热（0代表关闭；1代表打开） service_area String 华为云CDN提供的加速服务范围，包含：mainland_china中国大陆、outside_mainland_china中国大陆境外、global全球。 range_status String Range回源状态（off代表关闭 on代表开启）。 follow_status String 回源跟随状态（off代表关闭 on代表开启）。 origin_status String 是否暂停源站回源（off代表关闭 on代表开启）。 banned_reason String 域名禁用原因。 1：该域名涉嫌违规内容（涉黄/涉赌/涉毒/涉政）已被禁用； 2：该域名因备案失效已被禁用； 3：该域名遭受攻击，已被禁用； 150：该域名涉嫌违规内容涉黄已被禁用； 151：该域名涉嫌违规内容涉政已被禁用； 152：该域名涉嫌违规内容涉暴已被禁用； 153：该域名涉嫌违规内容涉赌已被禁用。 locked_reason String 域名锁定原因（Changing the config, please wait）。 enterprise_project_id String 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，不传表示查询默认项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。 表6 SourceWithPort 参数 参数类型 描述 domain_id String 加速域名id。 ip_or_domain String 源站IP（非内网IP）或者域名。 origin_type String 源站类型（"ipaddr"： "IP源站"；"domain"： "域名源站"；"obs_bucket"： "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 表7 DomainOriginHost 参数 参数类型 描述 domain_id String 域名ID。获取方法请参见查询加速域名。 origin_host_type String 回源host的类型。 customize_domain String 自定义回源host域名。

响应示例 状态码： 200 OK { "domain" : { "sources" : [ { "domain_id" : "12a***********************345d671", "origin_type" : "ipaddr", "ip_or_domain" : "10.62.53.75", "active_standby" : 1, "http_port" : 80, "https_port" : 443 } ], "cname" : "www.example1.com.c.example2.com", "id" : "12a***********************345d671", "user_domain_id" : "1a23***********************4a441", "domain_name" : "www.example1.com", "business_type" : "web", "service_area" : "mainland_china", "domain_status" : "online", "https_status" : 0, "create_time" : 1516861994806, "modify_time" : 1532405346365, "domain_origin_host" : { "domain_id" : "12a***********************345d671", "origin_host_type" : "customize", "customize_domain" : "www.example4.com" }, "disabled" : 0, "locked" : 0, "range_status" : "off", "follow_status" : "off", "origin_status" : "on", "auto_refresh_preheat" : 0 } }

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

请求消息 请求参数 请求参数如表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(请求总数)。 carrier 是 String 运营商列表，英文首字母缩写，目前支持CTCC（中国电信）, CUCC（中国联通）, ENET（教育）, CMCC（中国移动）, CRC（铁通），多个运营商之间以逗号分隔，如：CTCC,CMCC,........ ALL表示查询全部运营商。 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。 请求样例 请求路径示例 GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/carrier-detail-summary?start_time=1511366400000&end_time=1511452799640&domain_name=ALL&stat_type=req_num&carrier=CMCC,CTCC&enterprise_project_id=0

响应消息 响应参数 响应参数如表2所示。 表2 响应参数 名称 参数类型 描述 carrier_data Array of objects 运营商数据。详细说明见表3。 carrier_data参数说明 carrier_data参数说明如表3所示。 表3 carrier_data参数说明 名称 参数类型 描述 carrier String 运营商。 value Integer 对应查询类型的值。（流量单位：Byte，带宽单位：bps） 响应示例 { "carrier_data": [ { "carrier":"CMCC", "value": 857 }, { "carrier": "CTCC", "value": 545 } ] }

URI PUT /v1.0/cdn/domains/{domain_id}/ip-acl 表1 路径参数 参数 是否必选 参数类型 描述 domain_id 是 String 需要设置IP黑白名单的域名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参数 参数 是否必选 参数类型 描述 type 是 Integer IP黑白名单类型（0：关闭IP黑白名单功能，1：黑名单，2：白名单）。 ip_list 否 Array of strings IP黑白名单列表。 数组长度：1 - 100

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 domain CreateDomainResponseBodyContent object 创建域名返回信息。 表6 CreateDomainResponseBodyContent 参数 参数类型 描述 id String 加速域名ID。 domain_name String 加速域名。 business_type String 域名业务类型： web:网站加速； download:文件下载加速； video:点播加速； wholeSite:全站加速。 service_area String 域名服务范围，若为mainland_china，则表示服务范围为中国大陆；若为outside_mainland_china，则表示服务范围为中国大陆境外；若为global，则表示服务范围为全球。 user_domain_id String 域名所属用户的domain_id。 domain_status String 加速域名状态。取值意义： online表示“已开启” offline表示“已停用” configuring表示“配置中” configure_failed表示“配置失败” checking表示“审核中” check_failed表示“审核未通过” deleting表示“删除中”。 cname String 加速域名对应的CNAME。 sources Array of Sources objects 源站信息。 domain_origin_host DomainOriginHost object 域名回源HOST配置。 https_status Integer 是否开启HTTPS加速。 create_time Long 域名创建时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。 modify_time Long 域名修改时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。 disabled Integer 封禁状态（0代表未禁用；1代表禁用）。 locked Integer 锁定状态（0代表未锁定；1代表锁定）。 range_status String range状态，off：关闭，on：开启。 follow_status String follow302状态，off：关闭，on：开启。 origin_status String 是否暂停源站回源（off代表关闭 on代表开启）。 auto_refresh_preheat Integer 自动刷新预热（0代表关闭；1代表打开）。 表7 Sources 参数 参数类型 描述 domain_id String 加速域名id。 ip_or_domain String 源站IP（非内网IP）或者域名。 origin_type String 源站类型取值：ipaddr：源站IP、 domain：源站域名、obs_bucket：OBS桶域名。 active_standby Integer 主备状态，1代表主源站，0代表备源站。 enable_obs_web_hosting Integer 是否开启OBS静态网站托管(0表示关闭,1表示则为开启)，源站类型为obs_bucket时传递。 表8 DomainOriginHost 参数 参数类型 描述 domain_id String 域名ID。 origin_host_type String 回源host的类型,accelerate：选择加速域名作为回源host域名， customize：使用自定义的域名作为回源host域名。 customize_domain String 回源host域名。返回加速域名主源站设置的HOST域名，如果加速域名有多个主源站且对应多个回源HOST，则返回源站配置中的第一个主源站对应的HOST域名。

请求示例 POST https://cdn.myhuaweicloud.com/v1.0/cdn/domains { "domain" : { "domain_name" : "example1.example2.example3.com", "business_type" : "web", "sources" : [ { "ip_or_domain" : "0.0.0.0", "origin_type" : "ipaddr", "active_standby" : 1 } ], "service_area" : "mainland_china", "enterprise_project_id" : "0" } }

响应示例 状态码： 200 OK { "domain" : { "sources" : [ { "domain_id" : "ff80*************************07b", "ip_or_domain" : "0.0.0.0", "origin_type" : "ipaddr", "active_standby" : 1 } ], "id" : "ff80*************************07b", "user_domain_id" : "38***********************5024dcb", "domain_name" : "example11.example2.example3.com", "business_type" : "web", "service_area" : "mainland_china", "cname" : "example1.example2.example3.com.c.example4.com", "domain_status" : "configuring", "https_status" : 0, "create_time" : 1513152634467, "modify_time" : 1513152634467, "domain_origin_host" : { "domain_id" : "ff80*************************07b", "origin_host_type" : "customize", "customize_domain" : "example5.example6.com" }, "disabled" : 0, "locked" : 0, "range_status" : "off", "follow_status" : "off", "origin_status" : "on", "auto_refresh_preheat" : 0 } }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表2 请求Body参数 参数 是否必选 参数类型 描述 domain 是 DomainBody object 创建域名Body 表3 DomainBody 参数 是否必选 参数类型 描述 domain_name 是 String 加速域名。（ 由字母（A-Z，a-z，大小写等价）、数字（0-9）和连接符（-）组成，各级域名之间用（.）连接，域名长度不超过75个字符。连接符（-）不能作为域名的开头或结尾字符。） business_type 是 String 域名业务类型，若为web，则表示类型为网页加速；若为download，则表示业务类型为文件下载加速；若为video，则表示业务类型为点播加速；若为wholeSite，则表示业务类型为全站加速。 sources 是 Array of Sources objects 源站配置。 service_area 是 String 域名服务范围，若为mainland_china，则表示服务范围为中国大陆；若为outside_mainland_china，则表示服务范围为中国大陆境外；若为global，则表示服务范围为全球。 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示添加加速域名到该企业项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。 表4 Sources 参数 是否必选 参数类型 描述 domain_id 否 String 加速域名id。 ip_or_domain 是 String 源站IP（非内网IP）或者域名。 origin_type 是 String 源站类型取值：ipaddr：源站IP、 domain：源站域名、obs_bucket：OBS桶域名。源站为ipaddr时，仅支持IPv4，每个源站对应一个源站对象，最多支持50个源站。 active_standby 是 Integer 主备状态，1代表主源站，0代表备源站。 enable_obs_web_hosting 否 Integer 是否开启OBS静态网站托管(0表示关闭,1表示则为开启)，源站类型为obs_bucket时传递。

响应示例 状态码： 200 OK { "cdn_ips" : [ { "ip" : "192.168.1.1", "region" : "Sichuan", "platform" : null, "isp" : "Dianxin", "belongs" : true }, { "ip" : "192.168.1.2", "region" : "Unknown", "platform" : null, "isp" : null, "belongs" : false } ] }

URI GET /v1.0/cdn/ip-info 表1 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。 ips 是 String IP地址列表，以“，”分割，最多20个。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 cdn_ips Array of CdnIps objects IP归属信息列表。 表4 CdnIps 参数 参数类型 描述 ip String 需查询的IP地址。 belongs Boolean 是否是华为云CDN节点。（true:是华为云CDN节点，false:不是华为云CDN节点） region String IP归属地省份。（Unknown:表示未知归属地） isp String 运营商名称。如果IP归属地未知，该字段返回null。 platform String 平台。如果IP归属地未知，该字段返回null。

URI GET /v1.0/cdn/historytasks 表1 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。 page_size 否 Integer 单页最大数量，取值范围为1-10000。page_size和page_number必须同时传值。默认值30。 page_number 否 Integer 当前查询第几页，取值范围为1-65535。默认值1。 status 否 String 任务状态。 task_inprocess 表示任务处理中，task_done表示任务完成。 start_date 否 Long 查询起始时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。 end_date 否 Long 查询结束时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。 order_field 否 String 用来排序的字段，支持的字段有“task_type”：任务的类型，“total”：url总数，“processing”：处理中的url个数， “succeed”：成功处理的url个数，“failed”：处理失败的url个数，“create_time”：任务的创建时间。order_field和order_type必须同时传值，否则使用默认值"create_time" 和 "desc"：降序。 order_type 否 String desc：降序，或者asc：升序。默认值desc。 file_type 否 String 文件类型，file：文件；directory：目录。 task_type 否 String 任务类型，refresh：刷新任务；preheating：预热任务。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 total Integer 总共的任务个数。 tasks Array of TasksObject objects 日志列表数据 表4 TasksObject 参数 参数类型 描述 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 url总数。 create_time Long 任务的创建时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。 file_type String 文件类型，file：文件；directory：目录。

响应示例 状态码： 200 OK { "total" : 2, "tasks" : [ { "id" : "ff8080xxxxxxxxxxxxd816ff0128", "status" : "task_inprocess", "processing" : 2, "succeed" : 0, "failed" : 0, "task_type" : "refresh", "total" : 2, "create_time" : 1534240233215, "file_type" : "file" }, { "id" : "ff8080xxxxxxxxxxx4fe64797", "status" : "task_inprocess", "processing" : 1, "succeed" : 0, "failed" : 0, "task_type" : "refresh", "total" : 1, "create_time" : 1534240219944, "file_type" : "file" } ] }

响应示例 状态码： 200 OK { "domain" : { "sources" : [ { "domain_id" : "ff80***********************c82722", "origin_type" : "ipaddr", "ip_or_domain" : "0.0.0.0", "active_standby" : 1, "http_port" : 80, "https_port" : 443 } ], "cname" : "www.example1.example2.0002.example3.com.c.example4.com", "id" : "ff80808264c7*******fc82722", "user_domain_id" : "6e358a************a441", "domain_name" : "www.example1.example2.0002.example3.com", "business_type" : "web", "service_area" : "mainland_china", "domain_status" : "configuring", "https_status" : 0, "create_time" : 1532403213673, "modify_time" : 1532403782746, "domain_origin_host" : { "domain_id" : "ff80***********************c82722", "origin_host_type" : "accelerate", "customize_domain" : "www.example1.example2.0002.example3.com" }, "disabled" : 0, "locked" : 0, "range_status" : "off", "follow_status" : "off", "origin_status" : "on", "auto_refresh_preheat" : 0 } }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 domain DomainsWithPort object 域名信息。 表5 DomainsWithPort 参数 参数类型 描述 id String 加速域名ID。 domain_name String 加速域名。 business_type String 域名业务类型，若为web，则表示类型为网站加速；若为download，则表示业务类型为文件下载加速；若为video，则表示业务类型为点播加速；若为wholeSite，则表示类型为全站加速。 user_domain_id String 域名所属用户的domain_id。 domain_status String 加速域名状态。取值意义： online表示“已开启” offline表示“已停用” configuring表示“配置中” configure_failed表示“配置失败” checking表示“审核中” check_failed表示“审核未通过” deleting表示“删除中”。 cname String 加速域名对应的CNAME。 sources Array of SourceWithPort objects 源站配置。 domain_origin_host DomainOriginHost object 域名回源HOST配置。 https_status Integer 是否开启HTTPS加速。 0：代表未开启HTTPS加速； 1：代表开启HTTPS加速，且回源方式为协议跟随； 2：代表开启HTTPS加速，且回源方式为HTTP； 3：代表开启HTTPS加速，且回源方式为HTTPS。 create_time Long 域名创建时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。 modify_time Long 域名修改时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。 disabled Integer 封禁状态（0代表未禁用；1代表禁用）。 locked Integer 锁定状态（0代表未锁定；1代表锁定）。 auto_refresh_preheat Integer 自动刷新预热（0代表关闭；1代表打开）。 service_area String 华为云CDN提供的加速服务范围，包含：mainland_china中国大陆、outside_mainland_china中国大陆境外、global全球。 range_status String Range回源状态（off代表关闭 on代表开启）。 follow_status String 回源跟随状态（off代表关闭 on代表开启）。 origin_status String 是否暂停源站回源（off代表关闭 on代表开启）。 banned_reason String 域名禁用原因。 1：该域名涉嫌违规内容（涉黄/涉赌/涉毒/涉政）已被禁用； 2：该域名因备案失效已被禁用； 3：该域名遭受攻击，已被禁用； 150：该域名涉嫌违规内容涉黄已被禁用； 151：该域名涉嫌违规内容涉政已被禁用； 152：该域名涉嫌违规内容涉暴已被禁用； 153：该域名涉嫌违规内容涉赌已被禁用。 locked_reason String 域名锁定原因（Changing the config, please wait）。 enterprise_project_id String 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，不传表示查询默认项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。 表6 SourceWithPort 参数 参数类型 描述 domain_id String 加速域名id。 ip_or_domain String 源站IP（非内网IP）或者域名。 origin_type String 源站类型，ipaddr：源站IP、 domain：源站域名、obs_bucket：OBS桶域名。 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 表7 DomainOriginHost 参数 参数类型 描述 domain_id String 域名ID。 origin_host_type String 回源host的类型,accelerate：选择加速域名作为回源host域名， customize：使用自定义的域名作为回源host域名。 customize_domain String 回源host域名。返回加速域名主源站设置的HOST域名，如果加速域名有多个主源站且对应多个回源HOST，则返回源站配置中的第一个主源站对应的HOST域名。

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

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 origin_host DomainOriginHost object 回源HOST配置。 表5 DomainOriginHost 参数 参数类型 描述 domain_id String 域名ID。 origin_host_type String 回源host的类型,accelerate：选择加速域名作为回源host域名,customize：使用自定义的域名作为回源host域名。 customize_domain String 自定义回源host域名。