接口 DescribeCdnHostInfo 通过入参 statType 不同可指定查询峰值带宽、总流量、总请求数、平均请求数命中率数据，此文档对总流量查询方式进行了详细说明。
接口描述
DescribeCdnHostInfo 可用于查询域名在某一时间区间的总流量数据。
请求域名：cdn.api.qcloud.com
注意事项：
- 可一次提交多个域名、项目，查询各域名、项目下每一个域名的总流量。
- 流量数据 5 分钟为一个统计点，总流量为指定时间区间中统计点求和。
- 起始时间精确至日，起始时间设置为2017-11-29，实际查询起始时间点为2017-11-29 00:00:00，若结束时间设置为2017-11-29，实际查询结束时间点为2017-11-29 23:55:00。
- 若查询域名的总流量，需要传入对应的 projectId。
- 支持90天内的数据查询。
- 调用频次限制为100次/分钟。
- 接口已支持子账号调用，权限配置可参考权限 配置示例。
入参说明
以下请求参数列表仅列出了接口请求参数，正式调用时需要加上公共请求参数，见 公共请求参数 页面。其中，此接口的 Action 字段为 DescribeCdnHostInfo。
| 参数名称 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| startDate | 是 | String | 查询开始日期（日），如2016-05-03。 |
| endDate | 是 | String | 查询结束日期（日），如2016-05-04。 |
| statType | 是 | String | 统计量类型 "flux"：表示总流量。 |
| projects.n | 是 | String | 项目 ID，查看项目 ID。 |
| hosts.n | 否 | String | 域名列表。 |
详细说明
参数示例
hosts.0=www.test1.com&hosts.1=www.test2.com出参说明
| 参数名称 | 类型 | 描述 |
|---|---|---|
| code | Int | 公共错误码，0表示成功，其他值表示失败。 详见错误码页面 公共错误码。 |
| message | String | 模块错误信息描述，与接口相关。 |
| codeDesc | String | 英文错误信息，或业务侧错误码。 详见错误码页面 业务错误码。 |
| data | Array | 结果数据，详细说明见下文。 |
详细说明
data
| 参数名称 | 类型 | 描述 |
|---|---|---|
| start_datetime | String | 起始时间（日）。 |
| end_datetime | String | 结束时间（日）。 |
| period | Int | 数据采样时间间隔，单位为分钟。 |
| detail_data | Array | 汇总数据信息，详细说明见下文。 |
detail_data
| 参数名称 | 类型 | 描述 |
|---|---|---|
| host_name | String | 域名 |
| host_type | String | 域名类型 "cname"：自有源接入域名 "cos"：COS 源接入域名。 |
| host_value | Int | 总流量，单位为 Byte。 |
调用案例
示例参数
startDate：20160503
endDate：20160504
projects.0：0
statType：fluxGET 请求
GET 请求需要将所有参数都加在 URL 后：
https://cdn.api.qcloud.com/v2/index.php?
Action=DescribeCdnHostInfo
&SecretId=XXXXXXXXXXXXXXXXXXXXXXXXXXX
&Timestamp=1462781898
&Nonce=123456789
&Signature=XXXXXXXXXXXXXXXXXXXXXXXXXX
&startDate=20160503
&endDate=20160504
&statType=flux
&projects.0=0POST 请求
POST请求时，参数填充在 HTTP Request-body 中，请求地址：
https://cdn.api.qcloud.com/v2/index.php参数支持 form-data、x-www-form-urlencoded 等格式，参数数组如下：
array (
'Action' => 'DescribeCdnHostInfo',
'SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX',
'Timestamp' => 1462782282,
'Nonce' => 123456789,
'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX',
'startDate' => '20160503',
'endDate' => '20160504',
'statType' => 'flux',
'projects.0' => '0'
)结果示例
{
"code": 0,
"message": "",
"codeDesc": "Success",
"data": {
"start_datetime": "2016-05-03 00:00:00",
"end_datetime": "2016-05-04 23:55:00",
"period": 5,
"stat_type": "flux",
"detail_data": [
{
"host_id": "www.test.com",
"host_name": "www.test.com",
"host_type": "cname",
"host_value": 123456789
},
...
]
}
}
