文档中心 API 中心 云点播 云点播 API 2017 数据统计 查询按地区及运营商分布的 CDN 统计数据

查询按地区及运营商分布的 CDN 统计数据

最近更新时间:2019-05-10 09:39:33

接口名称

DescribeCdnRegionIspDetailStat

功能说明

查询指定域名指定日期按地区、运营商统计的国内 CDN 节点统计数据(流量、带宽和请求数)

  1. 返回的数据为每5分钟一个统计数据。
  2. 由于地区、运营商数据需要从日志中分析,数据延迟大概为20分钟 - 30分钟。
  3. 只能查询最近60天内的数据。
  4. 仅指定运营商,返回该运营商所有地区的统计数据。
  5. 仅指定地区,返回该地区所有运营商的统计数据。
  6. 不指定运营商也不指定地区,返回所有地区所有运营商的统计数据。
  7. 若某个地区或运营商无数据,不会返回。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
hosts Array 域名列表,如果为空,查询所有点播域名的统计数据,如果域名超过2个,返回错误
date String 查询日期,格式为 yyyy-MM-dd ,如2018-03-01
statType String CDN 统计数据类型
  • flux:流量,单位是字节(byte)
  • bandwidth:带宽,单位是比特每秒(bps)
  • requests:请求数
regionNames Array 要查询的 地区英文名称列表,如 Beijing ,如果为空,查询所有地区的数据
ispNames Array 要查询的 运营商英文名称列表,如 China Mobile ,如果为空,查询所有运营商的数据
COMMON_PARAMS 参见 公共参数

接口应答

参数说明

参数名称 类型 说明
code Integer 错误码,0:成功, 其他值:失败
message String 错误信息
data Object 结果数据
data.statType String CDN 统计数据类型,和请求的 statType 参数一致
data.hostData Array 每个域名的统计数据,见 HostRegionIspStatData 说明

HostRegionIspData 数据说明

参数名称 类型 说明
host String 域名
regionIspData Array 地区及运营商统计数据
regionIspData.regionEngName String 地区英文名称
regionIspData.regionZhName String 地区中文名称
regionIspData.ispEngName String 运营商英文名称
regionIspData.ispZhName String 运营商中文名称
regionIspData.statData Array 统计数据列表,每5分钟汇总一个统计数据,见 StatData

StatData 数据说明

参数名称 类型 说明
timeStamp Integer 统计数据所属时间,Unix 时间戳
value Integer 统计项数值

地区名称映射

英文名称 中文名称
Anhui 安徽
Beijing 北京
Chongqing 重庆
Fujian 福建
Gansu 甘肃
Guangdong 广东
Guangxi 广西
Guizhou 贵州
Hainan 海南
Hebei 河北
Heilongjiang 黑龙江
Henan 河南
Hubei 湖北
Hunan 湖南
Jiangsu 江苏
Jiangxi 江西
Jilin 吉林
Liaoning 辽宁
Inner Mongoria 内蒙古
Ningxia 宁夏
Qinghai 青海
Shandong 山东
Shanxi 山西
Shaanxi 陕西
Shanghai 上海
Sichuan 四川
Tianjin 天津
Tibet 西藏
Xinjiang 新疆
Yunnan 云南
Zhejiang 浙江
Hongkong Macao Taiwan 港澳台
Oversea 海外
Other 其它

运营商名称映射

英文名称 中文名称
China Unicom 中国联通
China Railcom 中国铁通
China Telecom 中国电信
China Mobile 中国移动
Cernet 教育网
Great Wall Broadband Network 长城宽带
Oevrsea Isp 海外运营商
Other 其它

错误码说明

错误码 含义说明
4000 - 7000 参见 公共错误码
1000 无效参数
17010 hosts 参数错误
17011 域名列表数据超过5个
17012 statType 参数错误
17015 date 参数错误

示例

请求示例

https://vod.api.qcloud.com/v2/index.php?Action=DescribeCdnRegionIspDetailStat
&hosts.0=123.vod2.myqcloud.com
&date=2018-03-01
&regionNames.0=Guangdong
&ispNames.0=China Mobile
&ispNames.1=China Unicom
&statType=flux
&COMMON_PARAMS

应答示例

{
    "code": 0,
    "message": "",
    "data": {
        "statType": "flux",
        "hostData": [{
            "host": "123.vod2.myqcloud.com",
            "regionIspData": [{
                    "regionZhName": "广东",
                    "regionEngName": "Guangdong",
                    "ispZhName": "中国移动",
                    "ispEngName": "China Mobile",
                    "statData": [{
                        "timeStamp": 1519833600,
                        "value": 12333
                    }, {
                        "timeStamp": 1519833900,
                        "value": 2333
                    }]
                },

                {
                    "regionZhName": "广东",
                    "regionEngName": "Guangdong",
                    "ispZhName": "中国联通",
                    "ispEngName": "China Unicom",
                    "statData": [{
                        "timeStamp": 1519833600,
                        "value": 12333
                    }, {
                        "timeStamp": 1519833900,
                        "value": 2333
                    }]
                }
            ]
        }]
    }
}