查询TOP100 URL明细
功能介绍
查询TOP100 URL明细。
支持查询90天内的数据。
查询跨度不能超过31天。
起始时间和结束时间,左闭右开,需要同时指定。如查询2021-10-24 00:00:00 到 2021-10-25 00:00:00 的数据,表示取 [2021-10-24 00:00:00, 2021-10-25 00:00:00)的统计数据。
开始时间、结束时间必须传毫秒级时间戳,且必须为凌晨0点整时刻点,如果传的不是凌晨0点整时刻点,返回数据可能与预期不一致。
流量类指标单位统一为Byte(字节)、请求数类指标单位统一为次数。用于查询指定域名、指定统计指标的明细数据。
单租户调用频率:5次/s。
URI
GET /v1.0/cdn/statistics/top-url
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
start_time |
是 |
Long |
查询起始时间戳,只能传0点毫秒时间戳 |
end_time |
是 |
Long |
查询结束时间戳,只能传0点毫秒时间戳 |
domain_name |
是 |
String |
域名列表,多个域名以逗号(半角)分隔,如:www.test1.com,www.test2.com all表示查询名下全部域名。如果域名在查询时间段内无数据,结果将不返回该域名的信息。 |
stat_type |
是 |
String |
|
service_area |
否 |
String |
服务区域:mainland_china(大陆),outside_mainland_china(海外),默认为global(全球) |
enterprise_project_id |
否 |
String |
当用户开启企业项目功能时,该参数生效,表示查询资源所属项目,"all"表示所有项目。注意:当使用子账号调用接口时,该参数必传。 |
请求参数
无
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
service_area |
String |
服务区域 |
top_url_summary |
Array of TopUrlSummary objects |
详情数据对象。 |
参数 |
参数类型 |
描述 |
---|---|---|
url |
String |
URL名称。 |
value |
Long |
对应查询类型的值。(流量单位:Byte) |
start_time |
Long |
查询起始时间戳。 |
end_time |
Long |
查询结束时间戳 |
stat_type |
String |
参数类型支持:flux(流量),req_num(请求总数)。 |
状态码: default
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrMsg object |
用于返回具体的错误码和错误消息 |
请求示例
查询TOP100 URL访问次数明细
GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/top-url?&start_time=1667030400000&end_time=1667116800000&domain_name=www.test1.com&stat_type=req_num&service_area=mainland_china&enterprise_project_id=all
查询TOP100 URL流量明细
GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/top-url?&start_time=1667030400000&end_time=1667116800000&domain_name=www.test1.com&stat_type=flux&service_area=mainland_china&enterprise_project_id=all
响应示例
状态码: 200
正常响应
查询TOP100 URL访问次数明细
{ "top_url_summary" : [ { "url" : "www.test1.com", "value" : 888, "start_time" : 1667030400000, "end_time" : 1667116800000, "stat_type" : "req_num" }, { "url" : "www.test2.com", "value" : 666, "start_time" : 1667030400000, "end_time" : 1667116800000, "stat_type" : "req_num" } ], "service_area" : "mainland" }
查询TOP100 URL流量明细
{ "top_url_summary" : [ { "url" : "www.test1.com", "value" : 1024, "start_time" : 1667030400000, "end_time" : 1667116800000, "stat_type" : "flux" }, { "url" : "www.test2.com", "value" : 1024, "start_time" : 1667030400000, "end_time" : 1667116800000, "stat_type" : "flux" } ], "service_area" : "mainland" }
状态码
状态码 |
描述 |
---|---|
200 |
正常响应 |
default |
异常响应 |
错误码
请参见错误码。