接口 GetCdnHostsDetailStatistics 通过入参 statType 不同可指定查询带宽、流量、请求数、命中请求数、命中流量、状态码等明细数据,此文档对命中请求数明细查询方式进行了详细说明。
接口描述
GetCdnHostsDetailStatistics 查询指定时间区间的命中请求数明细数据。
请求域名:
cdn.api.qcloud.com
注意事项:
命中请求数为由节点直接返回,未回源获取的请求数统计。
可一次提交多个域名(最多10个),查询每一个域名的实时命中请求数明细数据,及每一个域名累加后的实时命中请求数明细数据。
可一次提交一个或多个项目 ID,获取一个项目,或多个项目累加后的实时命中请求数明细数据。
不指定域名或项目可查询账号维度实时命中请求数数据。
命中请求数数据5分钟一个统计点,实时数据延迟5 - 10分钟。
支持60天内的数据查询,大于等于起始时间,小于等于结束时间。
默认情况下,时间区间3天以内数据粒度为5分钟明细;时间区间4 - 7天数据粒度为1小时(总命中请求数),时间区间8天及以上数据粒度为1天(总命中请求数)。
调用频次限制为100次/分钟。
接口已支持子账号调用,权限配置可参考权限 配置示例。
入参说明
参数名称 | 是否必选 | 类型 | 描述 |
startTime | 是 | String | 查询开始时间。 |
endTime | 是 | String | 查询结束时间。 |
statType | 是 | String | 统计量类型 "hit_requests":表示命中请求数明细。 |
projects.n | 否 | Int | |
hosts.n | 否 | String | 域名。 |
detail | 否 | String | 时间粒度 "1":均返回5分钟粒度明细数据 其他:按默认规则返回。 |
出参说明
详细说明
data
名称 | 类型 | 说明 |
start_datetime | String | 起始时间。 |
end_datetime | String | 结束时间。 |
period | String | 时间粒度。 |
requests | Array | 命中请求数明细,单位为 次(个)。 |
requests_total | Array | 多域名时,表示总命中请求数明细,单位为 次(个)。 |
调用案例
示例参数
startTime:2017-12-02 00:00:00endTime:2017-12-02 23:55:00hosts.0:www.test.comstatType:hit_requests
GET 请求
GET 请求需要将所有参数都加在 URL 后:
https://cdn.api.qcloud.com/v2/index.php?Action=GetCdnHostsDetailStatistics&SecretId=XXXXXXXXXXXXXXXXXXXXXX&Timestamp=1462416887&Nonce=123456789&Signature=XXXXXXXXXXXXXXXXXX&startTime=2017-12-02+00%3A00%3A00&endTime=2017-12-02+23%3A55%3A50&statType=hit_requests&hosts.0=www.test.com
POST 请求
POST请求时,参数填充在 HTTP Request-body 中,请求地址:
https://cdn.api.qcloud.com/v2/index.php
参数支持 form-data、x-www-form-urlencoded 等格式,参数数组如下:
array ('Action' => 'GetCdnHostsDetailStatistics','SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX','Timestamp' => 1462782282,'Nonce' => 123456789,'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX','startTime' => '2017-12-02 00:00:00','endTime' => '2017-12-02 23:55:00','statType' => 'hit_requests','hosts.0' => 'www.test.com')
结果示例
{"code": 0,"message": "","codeDesc": "Success","data": {"period": 5,"start_datetime": "2016-12-02 00:00:00","end_datetime": "2016-12-02 23:55:00","hit_requests": {"www.test.com": [12345,12345,...]},"hit_requests_total": [12345,12345,...]}}