文档首页> 内容分发网络 CDN> API参考> 历史API> 统计分析> 查询区域和运营商消耗统计
更新时间:2023-06-13 GMT+08:00

查询区域和运营商消耗统计

支持查询90天内的数据。

时间跨度最大不超过31天。

最多同时指定100个域名。

起始时间和结束时间需同时指定。开始时间、结束时间必须传毫秒级时间戳,且必须为采样间隔整时刻点。如采样间隔为5分钟,传入时间为2020-07-01 08:05:00、2020-07-01 08:10:00。

如果起始时间、结束时间不满足采样间隔的整时刻点,返回数据可能与预期不一致。

功能介绍

用于查询指定域名在指定区域、运营商、时间范围内的相关指标统计详情。

URI

GET /v1.0/cdn/statistics/region-carrier-detail

请求消息

请求参数

请求参数如表1所示。

表1 请求参数

名称

是否必选

参数类型

描述

start_time

Long

查询起始时间戳(单位:毫秒)。

end_time

Long

查询结束时间戳(单位:毫秒)。

domain_name

String

域名列表,多个域名以逗号(半角)分隔,如:www.test1.com,www.test2.com ,all表示查询名下全部域名。

stat_type

String

参数类型支持:flux(流量),bw(带宽),req_num(请求总数)

region

String

区域列表,包括:中国34个省级行政区域(包含中国大陆省份、直辖市及港澳台)、中国以外及其他,多个区域以逗号分隔,如:beijing,neimenggu,........

说明:
  • 传参时区域名称,如“北京、上海、港澳台”等均需用汉语拼音(beijing、shanghai、gangaotai),“中国以外”请用“haiwai”传参。
  • “山西、陕西”传参时分别用:“shanxi、shaanxi”。

ALL表示查询全部区域。

carrier

String

运营商列表,英文首字母缩写,目前支持CTCC(电信), CMCC(移动), CUCC(联通), ENET(教育), CRC(铁通)。多个运营商以逗号分隔,如:CTCC,CMCC,........。

ALL表示查询全部运营商。

region与carrier不能同时传ALL。

interval

Integer

采样间隔,单位:秒,取值说明:

时间跨度1天:5分钟、1小时、4小时、8小时。

时间跨度2~7天:5分钟、1小时、4小时、8小时、1天。

时间跨度8~31天:4小时、8小时、1天。

如果不传,默认取对应时间跨度的最小间隔。

如果需要传,则换算成秒。

enterprise_project_id

String

当用户开启企业项目功能时,该参数生效,表示查询资源所属项目,"all"表示所有项目。注意:当使用子帐号调用接口时,该参数必传。

请求示例

请求路径示例

GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/region-carrier-detail?start_time=1559318400000&end_time=1559577600000&domain_name=www.test1.com,www.test2.com,www.test3.com,www.test4.com&stat_type=req_num&region=beijing&carrier=CMCC&interval=86400&enterprise_project_id=0

响应消息

响应参数

响应参数如表2所示。

表2 响应参数

名称

参数类型

描述

region

Array of strings

区域。

carrier

Array of strings

运营商。

start_time

Integer

查询起始时间戳(单位:毫秒)。

end_time

Integer

查询结束时间戳(单位:毫秒)。

stat_type

String

参数类型支持:flux(流量),bw(带宽),req_num(请求总数)。

interval

Integer

采样间隔。

values

Array of integers

对应查询类型的返回值,根据查询时间粒度统计出不同时间段的数据,以逗号(半角)分隔。(流量单位:Byte,带宽单位:bps)

说明:

如果是查询多个域名,则返回值是各个域名统计数据的总和。

响应示例
{
    "region": [
        "beijing"
    ],
    "carrier": [
        "all"
    ],
    "start_time": 1559318400000,
    "end_time": 1559577600000,
    "stat_type": "req_num",
    "values": [
        66,
        64,
        68
    ],
    "interval": 86400
}

状态码

状态码请参见状态码

错误码

请参见错误码