全部文档
当前文档
最近更新时间：2021-09-18 18:11:41
本接口请求需要包含指定目录/2020-06-30/statistics/GetClientRequestData和公共请求header和该接口所特有的请求参数，具体请求语句参照下文请求示例。
| 参数名 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
| StartTime | 是 | String | 获取数据起始时间点，日期格式按ISO8601表示法，北京时间，格式为：YYYY-MM-DDThh:mm+0800，例如： 2016-08-01T21:10+0800 |
| EndTime | 是 | String | 结束时间需大于起始时间；获取日期格式按照ISO8601表示法，北京时间，格式为：YYYY-MM-DDThh:mm+0800，例如： 2016-08-01T21:15+0800 |
| Metric | 否 | String | 指定查询指标，支持的类型有：flow：流量，单位为 byte；bandwidth：带宽，单位为 bps；request：请求数，单位为 次；qps：平均每秒请求次数，单位：次，支持批量数据查询，多个类型用逗号（半角）分隔，默认为全部类型 |
| Interval | 否 | Long | 统计粒度，取值为 5：5分钟粒度；60：1小时粒度；1440：1天粒度； 5分钟及以上粒度的带宽值均取该粒度时间段内的5分钟粒度的峰值点,流量、请求数取值为求和值。 缺省为5分钟粒度。 5分钟粒度查询范围最大跨度为31天，其余粒度查询范围最大跨度为90天 |
| CdnType | 是 | String | 产品类型，只允许输入一种类型，取值为file：大文件下载，video：音视频点播，page：图片小文件；支持多个查询，多个类型用逗号分隔 |
| Domains | 否 | String | 当前账户下选择时间段内正在运行状态的加速域名，可输入需要查询的域名，支持批量域名查询，多个域名用逗号（半角）分隔，缺省为全部域名 |
| Areas | 否 | String | 网民分布区域简称，具体见【使用须知】，支持多区域查询，多个区域用逗号（半角）分隔，缺省为全部区域 |
| Provinces | 否 | String | 省份区域名称， 枚举类型表见【使用须知】；支持省份批量查询，多个省份用逗号（半角）分隔，缺省为全部省份（当Areas选项有且仅有中国大陆选项时，此类型生效，且支持数据展开），具体Provinces见下附录说明 |
| Isps | 否 | String | 运营商名称，枚举类型表见【使用须知】；只允许输入一种类型，缺省为全部运营商，（当Areas选项有且仅有中国大陆选项时，此类型生效，且支持数据展开），具体ISP见下附录说明 |
| IpType | 否 | String | IP类型，取值为ipv4:ipv4类型数据;ipv6:ipv类型数据；单选，缺省为全部IP类型 |
| Schema | 否 | String | 协议类型， 取值为http:http协议数据; https:https协议数据；quic：quic协议数据，单选，缺省为全部协议类型 |
| ResultType | 否 | String | 统计结果数据展示方式，支持不展开和展开，缺省为 不展开（unexpand）数据展开支持全部展开（expand）和按照指定查询维度展开，包含：域名（domain）、区域、省份（province）、运营商（isp）、IP类型（ip）、协议类型（schema） 支持多个条件组合展开，多个条件之间用半角逗号区分开来 —— PS:此处一共有31种组合数据包含关系如下：域名 > 省份 > 运营商 > IP 类型 > 协议类型 |
| 参数名 | 类型及范围 | 说明 |
|---|---|---|
| StartTime | String | 开始时间 |
| EndTime | String | 结束时间 |
| Metric | String | 本次查询指标 |
| Interval | Long | 粒度 |
| CdnType | String | 产品类型 |
| Domains | String | 域名列表，逗号（半角）间隔 |
| Areas | String | 区域，逗号（半角）间隔，枚举类型表见使用须知 |
| Provinces | String | 省份区域，枚举类型表见使用须知 |
| Isps | String | 运营商，枚举类型表见使用须知 |
| IpType | String | IP类型 |
| Schema | String | 协议类型 |
| ResultType | String | 是否展开，以及展开的维度，多个维度用逗号（半角）间隔 |
| Datas | Datas[] | 不同条件下的统计数据 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
| 参数名 | 类型及范围 | 说明 |
|---|---|---|
| Condition | Condition[] | 查询条件 |
| Data | Data[] | 查询数据 |
| 参数名 | 类型及范围 | 说明 |
|---|---|---|
| 参数名 | 类型及范围 | 说明 |
| Domains | String | 域名列表，逗号（半角）间隔 |
| Areas | String | 区域，逗号（半角）间隔 |
| Provinces | String | 省份区域，按查询条件展示，无此条件，则不展示 |
| Isps | String | 运营商，按查询条件展示，无此条件，则不展示 |
| IpType | String | IP类型，按查询条件展示，无此条件，则不展示 |
| Schema | String | 协议类型，按查询条件展示，无此条件，则不展示 |
| 参数名 | 类型及范围 | 说明 |
|---|---|---|
| Time | String | 时间点 |
| Bandwidth | Long | 对应时间点带宽峰值，按查询条件展示，无此条件，则不展示 |
| Flow | Long | 对应时间点流量，按查询条件展示，无此条件，则不展示 |
| Request | Long | 对应时间点请求数，按查询条件展示，无此条件，则不展示 |
| Qps | Double | 对应时间点 QPS，按查询条件展示，无此条件，则不展示 |
请求示例
GET方式：
GET /2020-06-30/statistics/GetClientRequestData?StartTime=2020-09-01T08%3a00%2b0800&EndTime=2020-09-01T08%3a05%2b0800&Metric=flow&Interval=5&CdnType=video&Areas=CN&Provinces=beijing&Isps=&IpType=&Schema=&ResultType=
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetClientRequestData
x-version: 2020-06-30
POST方式：
POST /2020-06-30/statistics/GetClientRequestData
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetClientRequestData
x-version: 2020-06-30
Content-Type: application/json
{
"StartTime": "2020-09-01T08:00+0800",
"EndTime": "2020-09-01T08:05+0800",
"Metric":"flow",
"Interval":"5",
"CdnType":"video",
"Areas": "CN",
"Provinces": "beijing",
"Isps": "",
"IpType": "",
"Schema": "",
"ResultType": ""
}
返回示例
{
"StartTime": "2020-09-01T08:00+0800",
"EndTime": "2020-09-01T08:05+0800",
"Metric": "flow",
"Interval": 5,
"CdnType": "video",
"Domains": "www.test.com",
"Areas": "CN",
"Provinces": "beijing",
"Isps": "PBS,CT,CTT,CE,UN,CM,Other",
"IpType": "ipv4,ipv6",
"Schema": "http,https,quic",
"ResultType": "unexpand",
"Datas": [
{
"Condition": {},
"Data": [
{
"Time": "2020-09-01T08:00+0800",
"Flow": 0.0
}
]
}
],
"RequestId": "7f9c419a-3f57-433b-8399-a9fcb68c8d8e"
}
纯净模式