YD T 3903-2021 内容分发网络技术要求 内容服务提供商侧接口.pdf

1、ICS 35.110 M11 YD 中华人民共和国通信行业标准 YD/T XXXXXXXXX 内容分发网络技术要求 内容服务提供商侧 接口 Techinical requirements for content distribution (delivery) network- content provider side interface （报批稿） XXXX - XX - XX 发布 XXXX - XX - XX 实施 中 华 人 民 共 和 国 工 业 和 信 息 化 部 发 布 I 目 次 前 言 .IV 引 言 .V 1 范围 .1 2 规范性引用文件 .1 3 术语定义及缩略语 .1

2、 3.1 术语和定义 .1 3.2 缩略语 .2 4 系统概述 .2 5 接口通用要求 .3 6 接口实现方式 1 .6 6.1 基础功能 .6 6.2 对象管理 .12 6.3 数据交换 .14 6.4 自查功能 .18 7 接口实现方式 2 .19 7.1 基础功能 .19 7.2 对象管理 .28 7.3 数据交换 .33 7.4 自查功能 .36 附录 A （资料性） 信息表 .40 II 前 言 本标准是内容分发网络技术要求系列标准之一，该系列标准名称和结构如下： 内容分发网络技术要求 功能体系架构 内容分发网络技术要求 内容路由 内容分发网络技术要求 应用场景和需求 内容分发网络技

3、术要求 互联应用场景 内容分发网络技术要求 边缘节点 内容分发网络技术要求 接口 内容分发网络技术要求 业务流程 内容分发网络技术要求 云分发 内容分发网络技术要求 支持 https的认证系统 内容分发网络技术要求 功能性框架 内容分发网络技术要求 汇聚节点 内容分发网络技术要求 内容中心 内容分发网络技术要求 业务统计信息 内容分发网络技术要求 全局路由节点 内容分发网络技术要求 用户侧接口 本标准按照 GB/T 1.1-2009给出的规则起草。 请注意本标准的某些内容可能涉及专利。本标准的发布机构不承担识别这些专利的责任。 本标准由中国通信标准化协会提出并归口。 本标准主要 起草单位 ：

4、阿里云计算有限公司、华为技术有限公司、 腾讯云科技有限公司、西安邮电 大学 、 中国信息通信研究院 、 中国电信集团有限公司 、 新华三技术有限公司 、 上海诺基亚贝尔股份有限 公司、陕西省信息化工程研究院。 本标准主要起草人：李克、张大江、孙腾飞、贾政、郝冲、姚振扬、袁林、李伟、张勇、聂秀英、 杨崑、陈戈、唐宏、廖龙、王晓月、朱志祥、万晓兰、黄峰。 III 引 言 内容分发网络服务商提供功能接口给内容服务提供商使用 。 随着内容分发网络服务的发展 ， 内容分 发网络服务商及其所服务的内容服务提供商对接口的自动化要求越来越高，需要解决的主要问题包括 ： a) 内容分发网络服务商需要服务多家内容

5、服务提供商 ， 接口标准不一致 ， 内容服务提供商对接口 的要求不合理； b) 内容服务提供商所对接内容分发网络服务商的接口功能要求类似 ， 但实现和格式多种多样 ， 导 致重复性劳动； c) 内容管控需要从源头抓起，管理指令到达内容分发网络终端信息不透明、记录格式不统一。 通过制定内容服务提供商侧接口要求 ， 可有效地解决上述问题 ， 对规范和统一我国内容分发网络服 务的运行 、 服务和管理 ， 提高内容分发网络服务的技术服务能力和互联互通能力 ， 规范内容分发网络服 务市场，推动我国内容分发网络服务的广泛应用十分必要。 1 内容分发网络技术要求 内容服务提供商侧接口 1 范围 本标准规定了

6、内容分发网络中的内容服务提供商侧侧接口要求 ， 包括功能要求 、 内容管理要求 、 数 据信息要求和接口安全要求。 本标准适用于内容分发网络服务商和内容服务提供商。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的 。 凡是注日期的引用文件 ， 仅注日期的版本适用于本文件 。 凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 YD/T 3212-2017 内容分发网络服务 信息安全管理系统接口规范 3 术语定义 及缩略语 3.1 术语和定义 下列术语和定义适用于本文件。 3.1.1 内容分发网络 content delivery network 增值电信业务，定义详

7、见中华人民共和国电信条例附录电信业务分类目录。 来源： YD/T 3212-2017，定义 3.3 3.1.2 内容分发网络服务商 content delivery network service provider 内容分发网络的提供者 ， 将访问量较大的网页内容和对象保存在服务器前端的专用缓存设备上 ， 以 此来提高网站访问的速度和质量，包括但不限于网页加速、下载加速、流媒体加速等。 3.1.3 内容服务提供商 content service provider 内容分发网络的使用者 ， 在内容分发网路上提供内容并进行内容加速 ， 包括通过内容分发网络服务 商获得网页加速、下载加速、流媒体加速

8、等服务。 3.1.4 2 加速域名 speedup domain 需要进行内容分发的网站或应用所使用的域名，即使用 CDN加速服务的域名。 3.1.5 源站 origin site 存储用户原始数据的主机。使用内容分发网络加速的内容从源站获取。 3.1.6 访问用户 access user 访问使用 CDN网络进行内容加速的有关网站和应用的外部用户。 3.1.7 CNAME 记录 CNAME record 别名 ， 可用来把一个域名解析到另一个域名 ， 当 DNS 系统在查询 CNAME 左面的名称的时候 ， 都会 转向 CNAME 右面的名称再进行查询。 3.1.8 数字证书 digital

9、 certificate 由证书认证机构 （ CA） 对证书申请者真实身份验证之后 ， 用 CA的根证书对申请人的一些基本信息以 及申请人的公钥进行签名（相当于加盖发证书机 构的公章）后形成的一个数字文件。 3.2 缩略语 下列缩略语适用于本文件。 AK：接入密钥 （ Access Key） CDN：内容分发网络 （ Content Delivery Network） CDNUI：内容管理网络接口（ Content Delivery Network User Interface） DNS：域名解析服务（ Domain Name System） HTTP：超文本传输协议（ Hypertext t

10、ransfer protocol） HTTPS：安全文本传输协议（ Hypertext transfer protocol over Secure） IDC：互联网数据中心（ Internet Data Center） ISP：互联网服务提供商（ Internet Service Provider） IP：互联网协议（ Internet Protocol） JSON：数据交换格式（ JavaScript Object Notation） SK：加密密钥（ Secret Key） XML：可扩展标记语言（ Extensible Markup Language） URL：统一资源定位符（ Unif

11、orm Resource Locator） 4 系统概述 3 CDN用户侧接口 （ CDNUI） 是内容分发网络服务商提供给内容服务提供商的一整套功能接口 ， 满足用 户在配置、监控、内容、监管等方面的功能和数据要求。 内容分发网络服务商和内容服务提供商，监管方之间的调用关系如图 1所示。 图 1 CDN用户侧接口调用关系 本标准规定了接口调用要求和用户侧的基本功能列表要求 。 内容分发网络服务商应支持第 7章或第 8 章中的接口实现方式之一。 5 接口通用要求 5.1 通讯方式 内容分发网络服务商应提供一个 CDN API的服务接口地址（ URL）， 端口默认为 80，如果支持 HTTPS，

12、 则端口应为 443。 内容服务提供商应按照接口说明 ， 在请求中加入相应请求参数来完成预定的指令 。 内容分发网络服 务商应返回结果对内容服务提供商的请求的处理结果。 5.2 请求方法 内容分发网络服务商应支持 HTTP GET发送请求，请求参数应包含在请求的 URL中。 如果是 POST调用， 对应的参数应封装在请求体中。 注： GET 指从指定的资源请求数据。 POST 指向指定的资源提交要被处理的数据。 5.3 请求参数 内容服务提供商发起的请求应包含公共参数和功能参数。 公共参数是每次调用都应携带的 ， 主要用于版本选择 ， 鉴权信息携带等 。 功能参数是对应的操作需 要的，如针对资

13、源申请，查询数据等场景。 公共参数如表 1所示。 内容分发网络 服务商 内容服务 提供商 CDNUI 监管方 下发 要求 下发 要求 响应 请求 4 表 1 公共参数 参数 类型 要求 示例 描述 ServiceProvider 字符串 必选 Aliyun 内容分发网络服务商的编码见附录 A。 Action 字符串 必选 AddCdnDomain 接口调用的功能名称。 Version 字符串 必选 2018-01-01 API版本号，为日期形式，如 YYYY-MM-DD。 AccessKeyId 字符串 必选 XXXXXX 服务商颁发给用户的密钥 ID， 标识访问者的身份，用于鉴权信息 Sig

14、nature的生成。 Signature 字符串 必选 XXXXXX 签名结果串 ， 服务商通过验证结果串来确保请求方身份，关于签名计算要求见 6.5。 Timestamp 字符串 必选 YYYY-MM-DDThh:mm:ssZ 请求的时间戳。日期格式按照 ISO8601标准表示，并应使用 UTC时间。 SignatureMethod 字符串 必选 HMAC-SHA256 支持的签名算法 ， 内容分发网络服务商可提供多个签名算法。 SignatureVersion 字符串 必选 1.0 签名算法版本 ， 内容分发网络服务商可提供多个版本的签名算法。 SignatureNonce 字符串 必选

15、XXXXXX 唯一随机数 ， 用于防止网络重放攻击 ， 用户在不通的请求间要使用不通的随机数。 Format 字符串 可选 JSON 返回结果值的类型 ， 应支持 JSON格式 ， 宜支持 XML格式。 5.4 返回结果 内容服务提供商发起调用 API服务后 ， 内容分发网络服务商应返回结果状态码 。 状态码 200表示请求 调用成功。状态码非 200时表示请求调用失败。 调用成功返回结果的数据格式默认为 JSON格式，可支持 XML格式。内容服务提供商可在请求时设置 参数来指定返回结果内容的数据格式 。 返回结果内容应包含 RequestId，用来唯一确定本次调用，方便排查问题。 如果是查询

16、类返回结果 ， 应将返回结果信息封装到返回结果体中 。 内容服务提供商可通过解析返回 结果的结果数据来进行业务处理。 正常情况下，内容分发网络服务商应对添加域名的请求返回结果一个 RequestId，为记录该操作的 唯一 id，用于审计和问题排查，返回结果格式可灵活组织，可包含 Code和 Message。例： RequestId:8906582E-6722-409A-A6C4-0E7863B733A5, /* 返回结果数据 */ 或者 Response: RequestId:8906582E-6722-409A-A6C4-0E7863B733A5,/* 返回结果数据 */ 5 如果出现异常，

17、内容分发网络服务商应在响应消息的 Code和 Message字段返回结果错误提示信息， 用于告诉内容提供商接口执行的错误原因。内容服务提供商可根据返回结果的 Code和 Message字段来进 行异常分析。例如： RequestId: 8906582E-6722-409A-A6C4-0E7863B733A5, Code: UnsupportedOperation, Message: The specified action is not supported. 5.5 鉴权要求 内容服务提供商发起的请求参数中应将鉴权信息带上，以便内容分发网络服务商进行安全性校验 。 内容分发网络服务商向内容服务

18、提供商提供 AccessKeyId和 AccessKeySecret，其中 AccessKeyId用 于标识内容服务提供商的身份， AccessKeySecret是用于加密签名字符串和服务器端验证签名字符串的 密钥。内容分发网络服务商和内容服务提供商应保证 AccessKeySecret的机密性 ，内容分发网络服务商 应提供 AccessKeySecret管理和更新机制。 内 容服务提供商在访问时，可按照下面的方法一、或者方法二对请求进行签名处理： 方法一： a) 使用请求参数构造规范化的请求字符串，对所有请求参数按参数名做字典序升序排列； b) 将步骤 1中排序好的请求参数格式化成 参数名

19、=参数值 的形式，参数之间用 分号隔开的域名列表。 include_empty Boolean 可选 false 是否包含空 Referer。 如果是黑名单并开启该选项 ， 则表示 无 referer不允许访问。 如果是白名单并开启该选项 ， 则表示 无 referer允许访问。 设置 Referer过滤规则返回结果见表 50。 8.1.2.2.4 更新缓存规则 设置 CDN节点上缓存资源的缓存策略对应的 Action = URI: PUT /./domains/domainId/cache，参数说明见表 40。请求参数如表 54所示。 表 54 设置缓存规则请求参数 名称 类型 要求 示例

20、描述 cache_config 对象 必选 缓存配置对象。详细说明见 表 55。 表 55 cache_config 参数说明 名称 类型 要求 示例 描述 ignore_url_parameter Boolean 可选 false 是否忽略 url中的参数。 rules 数组对象 可选 缓存规则，将覆盖之前的规 则配置。规则为空重置为默 认规则 。 详细信息参见下表 。 详细说明见表 56。 表 56 rules 参数说明 名称 类型 要求 示例 描述 rule_type 整数型 必选 1 0：全部类型，表示匹配所有文件，默认值。 1：文件类型，表示按文件后缀匹配。 27 名称 类型 要求

21、示例 描述 2：文件夹类型，表示按目录匹配。 3：文件全路径类型，表示按文件全路径匹配。 content 字符串 可选 .jpg;.png 缓存匹配设置。 当 rule_type为 0时，为空。 当 rule_type为 1时 ， 为文件后缀 ， 输入首字符为 “.”， 以 “;”进行分隔，如 .jpg;.zip;.exe。 当 rule_type为 2时，为目录，输入要求以 “/”作为首 字 符 ， 以 “;” 进 行 分 隔 ， 如 /test/folder01;/test/folder02。 ttl 整数型 必选 30 缓存时间。最大支持 365天。 ttl_type 整数型 必选 3

22、缓存时间单位。 1：秒； 2：分； 3：小时； 4：天。 priority 整数型 必选 1 此条配置的权重值 , 默认值 1， 数值越大 ， 优先级越 高。取值范围为 1-100，权重值不能相同。 设置缓存规则返回结果见表 54。 8.1.3 HTTPS 功能 设置加速域名 HTTPS。 通过配置加速域名的 HTTPS证书 ， 并将其部署在全网 CDN节点 ， 实现 HTTPS安全 加速。 对应的 Action为 URI: PUT /./domains/domain_id/https-info 参数说明见表 40。请求参数如表 57所示。 表 57 配置 HTTPS 请求参数 参数 类型 要

23、求 示例 描述 https 对象 必选 cdn_test_cert https对象。详细说明见表 58。 表 58 https 参数说明 参数 类型 要求 示例 描述 cert_name 字符串 必选 cdn_test_cert 证书名字。 https_status 整数型 必选 2 HTTPS证书是否启用。 0：不启用，此时 无需填写证书及私钥参数 ； 1： 启用 HTTPS 加速并协议跟随回源； 2：启用 HTTPS加 速并 HTTP回源，开启时需要传递证书及 私钥。 certificate 字符串 可选 -BEGIN CERTIFICATE-END CERTIFICATE- 功能说明：

24、HTTPS协议使用的证书内容 ， 不启用证书则无需输入。 取值范围： PEM编码格式。 private_key 字符串 可选 -BEGIN RSA PRIVATE KEY-END RSA PRIVATE KEY- 功能说明 ： HTTPS协议使用的私钥，不启 用证书则无需输入。 取值范围： PEM编码格式。 28 参数 类型 要求 示例 描述 force_redirec t_https 整数型 可选 0 客户端请求是否强制重定向。 1： 是， 0： 否。开启此项配置后，所有访问请求方 式都将强制跳转为 HTTPS访问。 http2 整数型 可选 0 是否使用 HTTP2.0。 1：是， 0：否

25、。 certificate_t ype 整数型 可选 0 证书类型。 1：代表云服务商托管证书 ； 0：表示自有证书。 配置 HTTPS返回结果如表 59所示。 表 59 配置 https 返回结果参数 参数 类型 示例 描述 https 对象 https对象。详细说明见表 60。 表 60 https 参数说明 参数 类型 要求 示例 描述 https_status 整 数 型 必选 2 https状态。 cert_name 字 符 串 必选 cdn_test_cert 证书名称。 certificate 字 符 串 可选 -BEGIN CERTIFICATE-END CERTIFICATE

26、- 证书内容。 force_redirect_https 整 数 型 可选 1 客户端请求是否强制重定 向。 1是， 0否。 http2 整 数 型 可选 1 是否使用 HTTP2.0。 1是 ， 0 否。 7.2 对象管理 8.2.1 刷新 内容服务提供商清理特殊 URL或者目录的缓存。 对应的 Action为 URI: POST /./refreshtasks， 其它参数携带该功能的一些必要信息 ， 如表 61 所示。 表 61 刷新 参数 类型 要求 示例 描述 Type 字符串 必选 file 刷新的类型，支持： file：文件刷新 29 directory：目录刷新 urls 字符串

27、 必选 对象列表 换行符（ n或 rn）分隔 返回结果如表 62所示。 表 62 刷新返回结果 参数 类型 示例 描述 id 字符串 ff808*2b35 任务 id。 task_type 字符串 refresh 任 务 的 类 型 ， 其 值 可 为 refresh 或 preheating。 status 字符串 task_inprocess 刷新结果。 task_done表示刷新成功 ， task_inprocess表示刷新中。 processing 整数型 2 处理中的 url个数。 succeed 整数型 0 成功处理的 url个数。 failed 整数型 0 处理失败的 url个数

28、。 total 整数型 2 总共的任务个数。 create_tim e 整数型 1566286450277 任务创建时间 ， 相对于 UTC 1970-01-01到当 前时间相隔的毫秒数。 urls 字符串数 组 , 刷新缓存的 url列表。 8.2.2 预热 内容服务提供商预加载特殊 URL的缓存，只支持 URL。 对应的 Action为 URI: POST /./preheatingtasks， 其它参数携带该功能的一些必要信息 ， 如表 63所示。 表 63 表 63 预热 参数 类型 要求 示例 描述 urls 字符串 必选 对象列表 换行符（ n或 rn）分隔 返回结果如表 64所示

29、。 表 64 预热返回结果 参数 类型 示例 描述 id 字符串 ff8080*c6e 任务 id。 task_type 字符串 preheating 任务的类型， 其值可为 refresh| preheating。 status 字符串 task_inprocess 预热结果。 task_done表示预热成功 30 ， task_inprocess表示预热中。 processing 整数型 2 处理中的 url个数。 succeed 整数型 0 成功处理的 url个数。 failed 整数型 0 处理失败的 url个数。 total 整数型 2 总共的任务个数。 create_time 整数

30、型 1566286450277 任务创建时间 ， 相对于 UTC 1970-01-01 到当前时间相隔的毫秒数。 urls 字符串数组 , 预热的 url。 8.2.3 查询刷新结果 内容服务提供商查询近期的刷新结果。 对应的 Action为 URI: GET /./historytasks， 其它参数携带该功能的一些必要信息 ， 如表 65所 示。 表 65 查询刷新结果 参数 类型 要求 示例 描述 page_size 可选 整数型 30 单页最大数量，取值范围为 1-10000。 page_number 可选 整数型 1 当前查询第几页 ， 取值范围为 1-65535。 status 可

31、选 字符串 task_inprocess 任务状态 。 task_inprocess 表示任务处理中， task_done表示任务完成。 start_date 可选 整数型 1534240233215 查询起始时间 ， 相对于 UTC 1970-01-01到当前时间相隔的毫秒数。 end_date 可选 整数型 1534240233215 查询结束时间 ， 相对于 UTC 1970-01-01到当前时间相隔的毫秒数。 order_field 可选 字符串 total 用来排序的字段，支持的字段有 “ task_type ” ， “ total ” ， “ processing ”， “ suc

32、ceed ”， “ failed ”， “ create_time ”。 order_field和 order_type应同时传值 。 order_type 可选 字符串 asc desc 或者 asc。 file_type 可选 字符串 file 默 认 是 文 件 file 。 file ： 文件 ,directory：目录。 task_id 可选 字符串 ff8080 xxxxxxxxxxxxd816ff0128 任务 id。 刷新的返回结果如表 66所示。 表 66 刷新返回结果 参数 类型 示例 描述 31 total 整数型 2 总数。 tasks 数组对象 日志列表数据，详细说明

33、见表 67。 表 67 tasks 参数说明 参数 类型 示例 描述 id 字符串 ff8080 xxxxxxxxxxxxd816ff0128 任务 id。 task_type 字符串 refresh 任务的类型， 其值可 为 refresh或 preheating。 status 字符串 task_inprocess 刷新结果。 task_done表示刷新成功 ， task_inprocess表示刷新中。 processing 整数型 2 处理中的 url个数。 succeed 整数型 0 成功处理的 url个数。 failed 整数型 0 处理失败的 url个数。 total 整数型 2

34、总共的任务个数。 create_time 整数型 1534240233215 任务的创建时间， 相对于 UTC 1970-01-01到当前时间相隔的毫秒数。 urls 字符串数组 刷新预热的 url。 file_type 字符串 file 默认是文件 file。 file： 文件 ,directory： 目录。 task_id 字符串 ff8080 xxxxxxxxxxxxd816ff0128 任务 id。 8.2.4 查询预热结果 内容服务提供商查询近期的预热结果。 对应的 Action为 URI: GET /./historytasks， 其它参数携带该功能的一些必要信息 ， 如表 68所

35、 示。 表 68 查询预热结果 参数 类型 要求 示例 描述 page_size 可选 整数型 30 单页最大数量，取值范围为 1-10000。 page_number 可选 整数型 1 当前查询第几页 ， 取值范围为 1-65535。 status 可选 字符串 task_inprocess 任务状态 。 task_inprocess 表示任务处理中， task_done表示任务完成。 start_date 可选 整数型 1534240233215 查询起始时间 ， 相对于 UTC 1970-01-01到当前时间相隔的毫秒数。 end_date 可选 整数型 1534240233215 查询

36、结束时间 ， 相对于 UTC 1970-01-01 32 到当前时间相隔的毫秒数。 order_field 可选 字符串 total 用来排序的字段，支持的字段有 “ task_type ” ， “ total ” ， “ processing ”， “ succeed ”， “ failed ”， “ create_time ”。 order_field和 order_type应同时传值 。 order_type 可选 字符串 asc desc 或者 asc。 file_type 可选 字符串 file 默 认 是 文 件 file 。 file ： 文件 ,directory：目录。 ta

37、sk_id 可选 字符串 ff8080 xxxxxxxxxxxxd816ff0128 任务 id。 预热的返回结果如表 69所示。 表 69 预热返回结果 参数 类型 示例 描述 total 整数型 2 总数。 tasks 数组对象 日志列表数据，详细说明见表 70。 表 70 tasks 参数说明 参数 类型 示例 描述 id 字符串 ff8080 xxxxxxxxxxxxd816ff0128 任务 id。 task_type 字符串 refresh 任务的类型， 其值可 为 refresh或 preheating。 status 字符串 task_inprocess 刷新结果。 task_

38、done表示刷新成功 ， task_inprocess表示刷新中。 processing 整数型 2 处理中的 url个数。 succeed 整数型 0 成功处理的 url个数。 failed 整数型 0 处理失败的 url个数。 total 整数型 2 总共的任务个数。 create_time 整数型 1534240233215 任务的创建时间， 相对于 UTC 1970-01-01到当前时间相隔的毫秒数。 urls 字符串数组 刷新预热的 url。 file_type 字符串 file 默认是文件 file。 file： 文件 ,directory： 目录。 task_id 字符串 ff8

39、080 xxxxxxxxxxxxd816ff0128 任务 id。 33 7.3 数据交换 8.3.1 统计分析 用于查询域名指标统计数据 ， 包括持统计详情查询 、 统计汇总查询 、 基础指标或组合指标 ， 组合指 标按子指标返回结果。对应的 Action为 GET /./statistics/domain-stats 或 Action = POST /./statistics/domain-stats，其它参数携带该功能的一些必要信息，如表 71所示。 表 71 查询域名统计数据 参数 类型 要求 示例 说明 action 字符串 必选 detail 查询分类： detail（统计详情）

40、summary（统计汇总） location_detail（区域 /运营商统计详 情） location_summary（区域 /运营商统计汇 总） start_time 长整型 必选 1515996000000 查询起始时间戳 （毫秒 ） ， 建议设为 5分钟 整时刻点 end_time 长整型 必选 1515996000000 查询结束时间戳 （毫秒 ） ， 建议设为 5分钟 整时刻点 interval 整数型 可选 300 采样间隔，单位：秒，取值说明： 300(5分钟 )，默认 300 domain_name 字符串 必选 域名列表 ， 多个域名以逗号 （半角 ） 分隔 ， 如： ,

41、all表示查询名下全部域名 stat_type 字符串 必选 flux 网络资源消耗： bw（带宽 ） ， flux（流 量 ） ， bs_bw(回源带宽 )， bs_flux（回源 流量） 访问情况 ： req_num（请求总数 ） ， hit_num （请求命中次数 ） ， bs_num(回源总数 )， bs_fail_num(回源失败数 ) ， hit_flux （命中流量） HTTP 状 态 码 （ 组 合 指 标 ） ： status_code_2xx( 状 态 码 2xx) ， status_code_3xx( 状 态 码 3xx) ， status_code_4xx( 状 态 码

42、 4xx) ， status_code_5xx( 状 态 码 5xx) ， bs_status_code_2xx(回源状态码 2xx)， 34 参数 类型 要求 示例 说明 bs_status_code_3xx(回源状态码 3xx)， bs_status_code_4xx(回源状态码 4xx)， bs_status_code_5xx(回源状态码 5xx) region 字符串 可选 beijing 区域列表，以逗号分隔： 1、 all表示查询全部区域 2、不传表示不区分区域 isp 字符串 可选 CMCC 运营商列表，以逗号分隔 1、 all表示查询全部运营商 2、不传表示不区分运营商 gro

43、up_by 字符串 可选 domain 数据分组方式 ， 多个以英文逗号分隔 ， 可 选 domain，默认不分组 area 字符串 可选 mainland_china 服务区域 mainland_china 、 outside_mainland_china params 字符串 可选 自定义参数，用于特殊场景，一般无用 返回结果如表 72所示。 表 72 查询域名统计数据返回结果 参数 类型 要求 示例 说明 start_time 长整型 必选 1515996000000 规整后的查询起始时间戳。 end_time 长整型 必选 1515999600000 规整后的查询结束时间戳。 interval 整数型 可选 300 stat_type 字符串 必选 flux 指标类型。 action 字符串 必选 detail 查询分类。 group_by 字符串 可选 domain 数据分组方式 results 对象 必选 results: flux: 0,1,2,3,4,5,6,7,8,9,10,11 详情数据列表。 域名名称 字符串 可选 如果查询的一个域名不存在 ， 则不返回结 果该域名。 指标类型 字符串 可选 flux 对应的查询指标。 35 参数 类型 要求 示例 说明 区域名称 字符串 可选 beijing 对应查询的区域代码 ， 如果没有数据 ， 则