接口 GetCdnStatTop 通过入参 statType 不同可指定查询按流量/请求数排序的 TOP 省份、TOP 运营商、TOP URL,此文档对流量 TOP 查询进行详细说明
接口描述
GetCdnStatTop 用于查询多域名 / 项目指定时间区间按流量排名的 TOP 1000 URL 列表、省份 TOP 排名、运营商 TOP 排名。
请求域名:cdn.api.qcloud.com
Note:
可一次提交多个域名,查询整体流量 TOP1000 URL、省份 TOP 排名、运营商 TOP 排名,需填充对应 projectId
可一次提交多个项目,查询整体流量 TOP1000 URL、省份 TOP 排名、运营商 TOP 排名
TOP 数据从日志中计算获取,数据延迟约30分钟
支持查询90天内的 TOP 数据
调用频次限制为100次 / 分钟
接口已支持子账号调用,权限配置可参考权限 配置示例
可一次提交多个域名,查询整体流量 TOP1000 URL、省份 TOP 排名、运营商 TOP 排名,需填充对应 projectId
可一次提交多个项目,查询整体流量 TOP1000 URL、省份 TOP 排名、运营商 TOP 排名
TOP 数据从日志中计算获取,数据延迟约30分钟
支持查询90天内的 TOP 数据
调用频次限制为100次 / 分钟
接口已支持子账号调用,权限配置可参考权限 配置示例
入参说明
参数名称 | 是否必选 | 类型 | 描述 |
startDate | 是 | String | 查询开始时间(日) |
endDate | 是 | String | 查询结束时间(日) |
projects.n | 是 | String | 项目 ID |
hosts.n | 否 | String | 域名 |
statType | 是 | String | "flux":表示按流量排序 |
出参说明
详细说明
data
名称 | 类型 | 说明 |
province_data | Array | 省份排名,结构说明见下文 |
isp_data | Array | 运营商排名,结构说明见下文 |
url_data | Array | URL排名,结构说明见下文 |
start_datetime | String | 起始日期 |
end_datetime | String | 结束日期 |
stat_type | String | 排名依据 |
period | Int | 时间粒度 |
province_data
名称 | 类型 | 说明 |
id | Int | 省份编号 |
name | String | 省份名称,如“吉林” |
value | Int | 流量值,单位为 byte |
isp_data
名称 | 类型 | 说明 |
id | Int | 运营商编号 |
name | String | 运营商名称,如“中国移动” |
value | Int | 流量值,单位为 byte |
url_data
名称 | 类型 | 说明 |
name | String | URL |
value | Int | 流量值,单位为 byte |
调用案例
示例参数
startDate:20160503endDate:20160504projects.0:0hosts.0:www.test.comstatType:flux
GET 请求
GET 请求需要将所有参数都加在 URL 后:
https://cdn.api.qcloud.com/v2/index.php?Action=GetCdnStatTop&SecretId=XXXXXXXXXXXXXXXXXXXXXXXXX&Timestamp=1462421433&Nonce=123456789&Signature=XXXXXXXXXXXXXXXXXXXXXXXX&startDate=20160503&endDate=20160504&hosts.0=www.test.com&projects.0=0&statType=flux
POST 请求
POST请求时,参数填充在 HTTP Request-body 中,请求地址:
https://cdn.api.qcloud.com/v2/index.php
参数支持 form-data、x-www-form-urlencoded 等格式,参数数组如下:
array ('Action' => 'GetCdnStatTop','SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX','Timestamp' => 1462782282,'Nonce' => 123456789,'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX','startDate' => '20160503','endDate' => '20160504','projects.0' => '0','hosts.0' => 'www.test.com','statType' => 'flux')
结果示例
{"code": 0,"message": "","codeDesc": "Success","data": {"start_datetime": "2016-05-03","end_datetime": "2016-05-04","stat_type": "flux","period": 5,"province_data": [{"id": 1051,"name": "重庆","value": 207}...],"isp_data": [{"id": 2,"name": "中国电信","value": 207}...],"url_data": [{"name": "www.test.com/robots.txt","value": 212},{"name": "www.test.com/","value": 207}]}}