运营商地区消耗明细

最近更新时间:2018-11-07 17:19:45

1. 接口描述

本接口(GetCdnOverseaProvIspDetailStat)用于查询指定日期、指定运营商、指定地区、指定域名的消耗明细,时间粒度为5分钟,一天288个统计点。由于地区/省份需要从日志中分析,数据延迟大概为20-30分钟。注:本接口的调用频率请控制在每分钟一百次内。

接口请求域名:cdn.api.qcloud.com

调用Demo

详细说明:

  • 使用本接口查询的域名需接入腾讯云境外 CDN;
  • 由于地区-运营商组合结果非常多,且本接口返回的为细粒度的数据,数据量较大,暂时不支持过多域名同时查询,一次最多可查询5个域名;
  • 目前不细化境外运营商,境外运营商统一编码为-1;
  • 若不填充运营商,仅指定地区,则返回该每一个运营商的消耗明细,支持指定多个地区查询;
  • 若不填充运营商,也不指定地区,则返回每个地区每一个运营商的消耗明细;
  • 若无数据,则不会返回。

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。其中,此接口的Action字段为GetCdnOverseaProvIspDetailStat。

参数名称 是否必选 类型 描述
date String 查询日期,格式必须为:2016-11-20
hosts.n String 域名,支持多个,如hosts.0=www.test.com&hosts.1=www.test2.com,最多可查询5个
provs.n String 指定地区,地区通过编码区分,编码参考下文中境外 CDN日志地区编码映射表
isps.n String 指定运营商,运营商通过编码区分,编码参考下文中境外 CDN日志地区编码映射表
statType String 指定查询类型,支持七种数据的查询,bandwidth对应带宽数据,单位为bps;requests对应请求数据,单位为个;flux对应流量数据,单位为Byte;statuscode对应状态码,单位为个;dlspeed对应下载速度,单位为bit/s;dltime对应下载用时,单位为s;hitrate对应命中率,单位为百分比

境外 CDN日志地区编码映射表

73:印度、1195:印度尼西亚、1176:新加坡、57:泰国、144:越南、3701:马来西亚、2588:菲律宾、2026:中国台湾、1044:日本、3379:韩国、1200:中国香港、3839:加拿大、669:美国、-2:境外其他地区、-3:未知;

境外 CDN日志运营商编码映射表

-1:境外运营商;

3. 输出参数

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

data 字段说明

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

4. 示例

4.1 输入示例

date: 2016-11-20
hosts.0: www.test.com
provs.0: 57
isps.0: -1

4.2 GET 请求

GET 请求需要将所有参数都加在 URL 后:

https://cdn.api.qcloud.com/v2/index.php?
Action=GetCdnOverseaProvIspDetailStat
&SecretId=XXXXXXXXXXXXXXXXXXXXXX
&Timestamp=1462416887
&Nonce=123456789
&Signature=XXXXXXXXXXXXXXXXXX
&date=2016-11-20
&hosts.0=www.test.com
&provs.0=57
&isps.0=-1
&statType=bandwidth

4.3 POST 请求

POST请求时,参数填充在 HTTP Request-body 中,请求地址:

https://cdn.api.qcloud.com/v2/index.php

参数支持 form-data、x-www-form-urlencoded 等格式,参数数组如下:

array (
  'Action' => 'GetCdnOverseaProvIspDetailStat',
  'SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX',
  'Timestamp' => 1462782282,
  'Nonce' => 123456789,
  'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX',
  'date' => '2016-11-20',
  'hosts.0' => 'www.test.com',
  'provs.0' => '57',
  'isps.0' => '-1',
  'statType' => 'bandwidth'
)

4.4 返回结果示例

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "date": "2016-09-28",
        "prov_data": {
            "www.test.com": [
                {
                    "id": 57,
                    "name": "泰国",
                    "host": "www.test.com",
                    "isp_value": {
                        "bandwidth": {
                            "-1": [
                                1,
                                1,
                                1,
                                0,
                                ...
                            ]
                        }
                    }
                }
            ]
       }
    }
}