按区域运营商查询域名统计数据
功能介绍
支持查询90天内的数据。
支持多指标同时查询,不超过5个。
最多同时指定20个域名。
起始时间和结束时间需要同时指定,左闭右开,毫秒级时间戳,且时间点必须为与查询时间间隔参数匹配的整时刻点。比如查询时间间隔为5分钟时,起始时间和结束时间必须为5分钟整时刻点,如:0分、5分、10分、15分等,如果时间点与时间间隔不匹配,返回数据可能与预期不一致。统一用开始时间表示一个时间段,如:2019-01-24 20:15:00 表示取 [20:15:00, 20:20:00)的统计数据,且左闭右开。
action取值:location_detail,location_summary
流量类指标单位统一为Byte(字节)、带宽类指标单位统一为bit/s(比特/秒)、请求数类和状态码类指标单位统一为次数。用于查询指定域名、指定统计指标的区域运营商明细数据。
单租户调用频率:15次/s。
调用方法
请参见如何调用API。
URI
GET /v1.0/cdn/statistics/domain-location-stats
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
action |
是 |
String |
|
start_time |
是 |
Long |
|
end_time |
是 |
Long |
|
domain_name |
是 |
String |
域名列表,多个域名以逗号(半角)分隔,如:www.test1.com,www.test2.com all表示查询名下全部域名。如果域名在查询时间段内无数据,结果将不返回该域名的信息。 |
stat_type |
是 |
String |
|
interval |
否 |
Long |
|
country |
否 |
String |
|
province |
否 |
String |
省份编码,当country为cn(中国)时有效,多个以英文逗号分隔,all表示全部,取值见附录 |
isp |
否 |
String |
运营商编码,多个以英文逗号分隔,all表示全部,取值见附录 |
group_by |
否 |
String |
数据分组方式,多个以英文逗号分隔,可选domain、country、province、isp,默认不分组 |
enterprise_project_id |
否 |
String |
当用户开启企业项目功能时,该参数生效,表示查询资源所属项目,"all"表示所有项目。注意:当使用子账号调用接口时,该参数必传。 |
请求参数
无
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
group_by |
String |
数据分组方式 |
result |
Map<String,Object> |
按指定的分组方式组织的数据 |
状态码: default
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrMsg object |
用于返回具体的错误码和错误消息 |
请求示例
不分组域名详情数据
GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/domain-location-stats?action=location_summary&start_time=1667030400000&end_time=1667116800000&domain_name=www.test1.com&stat_type=flux&interval=300&country=cn&province=sichuan&isp=dianxin&enterprise_project_id=all
按域名分组域名详情数据
GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/domain-location-stats?action=location_summary&start_time=1667030400000&end_time=1667116800000&domain_name=www.test1.com&stat_type=flux&interval=300&country=cn&province=sichuan&isp=dianxin&group_by=domain&enterprise_project_id=all
响应示例
状态码: 200
正常响应
不分组域名详情数据
{ "result" : { "flux" : [ 0, 1, 2 ] } }
按域名分组域名详情数据
{ "group_by" : "domain", "result" : { "www.test1.com" : { "flux" : [ 0, 1, 2 ] }, "www.test2.com" : { "flux" : [ 0, 1, 2 ] } } }
按国家分组域名详情数据
{ "group_by" : "country", "result" : { "cn" : { "flux" : [ 0, 1, 2 ] }, "jp" : { "flux" : [ 0, 1, 2 ] } } }
按省份分组域名详情数据
{ "group_by" : "province", "result" : { "sichuan" : { "flux" : [ 0, 1, 2 ] }, "hubei" : { "flux" : [ 0, 1, 2 ] } } }
按运营商分组域名详情数据
{ "group_by" : "isp", "result" : { "dianxin" : { "flux" : [ 0, 1, 2 ] }, "liantong" : { "flux" : [ 0, 1, 2 ] } } }
按域名、国家分组域名详情数据
{ "group_by" : "domain,country", "result" : { "www.test1.com" : { "cn" : { "flux" : [ 0, 1, 2 ] }, "gb" : { "flux" : [ 0, 1, 2 ] } }, "www.test2.com" : { "cn" : { "flux" : [ 0, 1, 2 ] }, "gb" : { "flux" : [ 0, 1, 2 ] } } } }
按域名、运营商分组域名详情数据
{ "group_by" : "domain,isp", "result" : { "www.test1.com" : { "dianxin" : { "req_num" : [ 0, 1, 2 ] } }, "www.test2.com" : { "dianxin" : { "req_num" : [ 0, 1, 2 ] } } } }
不分组域名总体数据
{ "result" : { "flux" : 1024 } }
按域名分组域名总体数据
{ "group_by" : "domain", "result" : { "www.test1.com" : { "flux" : 1024 }, "www.test2.com" : { "flux" : 1024 } } }
按国家分组域名总体数据
{ "group_by" : "country", "result" : { "cn" : { "flux" : 1024 }, "jp" : { "flux" : 1024 } } }
状态码
状态码 |
描述 |
---|---|
200 |
正常响应 |
default |
异常响应 |
错误码
请参见错误码。