运营商省份带宽明细

最近更新时间:2020-03-06 15:11:06

我的收藏

接口描述

GetCdnProvIspDetailStat 用于查询指定日期、指定运营商、指定省份、指定域名的带宽消耗明细的接口,时间粒度为5分钟,一天288个统计点。由于运营商/省份需要从日志中分析,数据延迟大概为20 - 30分钟。
接口域名:cdn.api.qcloud.com
Note:
由于省份-运营商组合结果非常多,且本接口返回的为细粒度的数据,数据量较大,暂时不支持太多域名同时查询,一次最多可查询 5 个域名。
若不填充省份仅指定运营商,则返回的全国每一个省份在该运营商的消耗明细,支持指定多个运营商查询。
若不填充运营商,仅指定省份,则返回该省份每一个运营商的消耗明细,支持指定多个省份查询。
若不填充运营商,也不指定省份,则返回每个省份每一个运营商的消耗明细。
若该省份或运营商无数据,则不会返回。
返回的带宽消耗明细单位为 bps。
接口已支持子账号调用,权限配置可参考权限 配置示例

入参说明

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 页面。其中,此接口的 Action 字段为 GetCdnProvIspDetailStat。
参数名称
是否必选
类型
描述
date
String
查询日期,格式必须为:2016-09-28
hosts.n
String
域名,支持多个<br/>hosts.0 = www.test.com&hosts.1 = www.test2.com<br/>最多可查询5个
provs.n
String
指定省份,省份通过编码区分<br/>详情请参见 CDN 日志省份编码映射表
isps.n
String
指定运营商,运营商通过编码区分<br/>详情请参见 CDN 日志运营商编码映射表

出参说明

参数名称
类型
描述
code
Int
公共错误码,0表示成功,其他值表示失败<br/>详见错误码页面的 公共错误码
message
String
模块错误信息描述,与接口相关
codeDesc
String
英文错误信息,或业务侧错误码<br/>详见错误码页面 业务错误码
data
Object
结果数据,详细说明见下文

data 字段说明

名称
类型
说明
date
String
输入时指定的起始日期(日)
prov_data
Object
省份数据明细,详细说明见下文
prov_data 字段说明
名称
类型
说明
id
Int
省份编码
name
String
省份
host
String
指定查询的域名
isp_value
Object
运营商信息,每一个运营商对应一个明细数组

调用案例

示例参数

date: 2016-09-28
hosts.0: www.test.com
provs.0: 1442
isps.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,
...
]
}
}
}
]
}
}
}