查询区域和运营商消耗统计
支持查询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所示。
|
名称 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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,........
说明：
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®ion=beijing&carrier=CMCC&interval=86400&enterprise_project_id=0
响应消息
响应参数
响应参数如表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
}
状态码
状态码请参见状态码。
错误码
请参见错误码。
