查询域名统计数据
功能介绍
- 支持查询90天内的数据。
- 支持多指标同时查询,不超过5个。
- 最多同时指定20个域名。
- 起始时间和结束时间需要同时指定,左闭右开,毫秒级时间戳,且时间点必须为与查询时间间隔参数匹配的整时刻点。比如查询时间间隔为5分钟时,起始时间和结束时间必须为5分钟整时刻点,如:0分、5分、10分、15分等,如果时间点与时间间隔不匹配,返回数据可能与预期不一致。统一用开始时间表示一个时间段,如:2019-01-24 20:15:00 表示取 [20:15:00, 20:20:00)的统计数据,且左闭右开。
- action取值:detail,summary
- 流量类指标单位统一为Byte(字节)、带宽类指标单位统一为bit/s(比特/秒)、请求数类和状态码类指标单位统一为次数。用于查询指定域名、指定统计指标的明细数据。
- 单租户调用频率:15次/s。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1.0/cdn/statistics/domain-stats
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
action |
是 |
String |
|
start_time |
是 |
Long |
|
end_time |
是 |
Long |
|
domain_name |
是 |
String |
域名列表,多个域名以逗号(半角)分隔,如:www.test1.com,www.test2.com all表示查询名下全部域名。如果域名在查询时间段内无数据,结果将不返回该域名的信息。 |
stat_type |
是 |
String |
|
interval |
否 |
Long |
|
group_by |
否 |
String |
数据分组方式,可选domain,默认不分组 |
service_area |
否 |
String |
服务区域:mainland_china(默认)、outside_mainland_china,当查询回源类指标时该参数无效。 |
enterprise_project_id |
否 |
String |
当用户开启企业项目功能时,该参数生效,表示查询资源所属项目,"all"表示所有项目。注意:当使用子账号调用接口时,该参数必传。 |
请求参数
无
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
result |
Map<String,Object> |
按指定的分组方式组织的数据 |
状态码: default
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrMsg object |
用于返回具体的错误码和错误消息 |
请求示例
- 不分组详情数据
GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/domain-stats?action=summary&start_time=1667030400000&end_time=1667116800000&domain_name=www.test1.com&stat_type=flux&interval=300&service_area=mainland_china&enterprise_project_id=all
- 按域名分组详情数据
GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/domain-stats?action=summary&start_time=1667030400000&end_time=1667116800000&domain_name=www.test1.com&stat_type=flux&interval=300&group_by=domain&service_area=mainland_china&enterprise_project_id=all
响应示例
状态码: 200
正常响应
- 不分组详情数据
{ "result" : { "503" : [ 1000, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ], "504" : [ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1000 ] } }
- 根据域名分组详情数据
{ "result" : { "www.test1.com" : { "200" : [ 118, 105, 113, 115, 114, 111, 106, 108, 118, 94, 97, 113 ], "206" : [ 115, 113, 125, 102, 132, 95, 133, 105, 117, 109, 128, 109 ] }, "www.test2.com" : { "200" : [ 118, 105, 113, 115, 114, 111, 106, 108, 118, 94, 97, 113 ], "206" : [ 115, 113, 125, 102, 132, 95, 133, 105, 117, 109, 128, 109 ] } } }
状态码
状态码 |
描述 |
---|---|
200 |
正常响应 |
default |
异常响应 |
错误码
请参见错误码。