内容分发网络 CDN 运营商地区消耗明细-API 文档-文档中心-腾讯云

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,
                                ...
                            ]
                        }
                    }
                }
            ]
       }
    }
}

运营商地区消耗明细

本页目录：