更新时间:2024-03-21 GMT+08:00

查询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

表1 Query参数

参数

是否必选

参数类型

描述

start_time

Long

查询起始时间戳,只能传0点毫秒时间戳

end_time

Long

查询结束时间戳,只能传0点毫秒时间戳

domain_name

String

域名列表,多个域名以逗号(半角)分隔,如:www.test1.com,www.test2.com all表示查询名下全部域名。如果域名在查询时间段内无数据,结果将不返回该域名的信息。

stat_type

String

  • 参数类型支持:flux(流量),req_num(请求数)

service_area

String

服务区域:mainland_china(大陆),outside_mainland_china(海外),默认为global(全球)

enterprise_project_id

String

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

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

service_area

String

服务区域

top_url_summary

Array of TopUrlSummary objects

详情数据对象。

表3 TopUrlSummary

参数

参数类型

描述

url

String

URL名称。

value

Long

对应查询类型的值。(流量单位:Byte)

start_time

Long

查询起始时间戳。

end_time

Long

查询结束时间戳

stat_type

String

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

状态码: default

表4 响应Body参数

参数

参数类型

描述

error

ErrMsg object

用于返回具体的错误码和错误消息

表5 ErrMsg

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

  • 查询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

异常响应

错误码

请参见错误码