接口描述
GetCdnProvIspDetailStat
用于查询指定日期、指定运营商、指定省份、指定域名的带宽消耗明细的接口,时间粒度为5分钟,一天288个统计点。由于运营商/省份需要从日志中分析,数据延迟大概为20 - 30分钟。
接口域名:
cdn.api.qcloud.com
Note:
由于省份-运营商组合结果非常多,且本接口返回的为细粒度的数据,数据量较大,暂时不支持太多域名同时查询,一次最多可查询 5 个域名。
若不填充省份仅指定运营商,则返回的全国每一个省份在该运营商的消耗明细,支持指定多个运营商查询。
若不填充运营商,仅指定省份,则返回该省份每一个运营商的消耗明细,支持指定多个省份查询。
若不填充运营商,也不指定省份,则返回每个省份每一个运营商的消耗明细。
若该省份或运营商无数据,则不会返回。
返回的带宽消耗明细单位为 bps。
接口已支持子账号调用,权限配置可参考权限 配置示例。
入参说明
参数名称 | 是否必选 | 类型 | 描述 |
date | 是 | String | 查询日期,格式必须为:2016-09-28 |
hosts.n | 是 | String | 域名,支持多个<br/>hosts.0 = www.test.com&hosts.1 = www.test2.com<br/>最多可查询5个 |
provs.n | 否 | String | |
isps.n | 否 | String |
出参说明
data 字段说明
名称 | 类型 | 说明 |
date | String | 输入时指定的起始日期(日) |
prov_data | Object | 省份数据明细,详细说明见下文 |
prov_data 字段说明
名称 | 类型 | 说明 |
id | Int | 省份编码 |
name | String | 省份 |
host | String | 指定查询的域名 |
isp_value | Object | 运营商信息,每一个运营商对应一个明细数组 |
调用案例
示例参数
date: 2016-09-28hosts.0: www.test.comprovs.0: 1442isps.0: 2
GET 请求
GET 请求需要将所有参数都加在 URL 后:
https://cdn.api.qcloud.com/v2/index.php?Action=GetCdnProvIspDetailStat&SecretId=XXXXXXXXXXXXXXXXXXXXXX&Timestamp=1462416887&Nonce=123456789&Signature=XXXXXXXXXXXXXXXXXX&date=2016-09-28&hosts.0=www.test.com&provs.0=1442&isps.0=2
POST 请求
POST请求时,参数填充在 HTTP Request-body 中,请求地址:
https://cdn.api.qcloud.com/v2/index.php
参数支持 form-data、x-www-form-urlencoded 等格式,参数数组如下:
array ('Action' => 'GetCdnProvIspDetailStat','SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX','Timestamp' => 1462782282,'Nonce' => 123456789,'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX','date' => '2016-09-28','hosts.0' => 'www.test.com','provs.0' => '1442','isps.0' => '2')
结果示例
{"code": 0,"message": "","codeDesc": "Success","data": {"date": "2016-09-28","prov_data": {"www.test.com": [{"id": 1442,"name": "浙江","host": "www.test.com","isp_value": {"bandwidth": {"2": [1,1,1,0,...]}}}]}}}