更新时间:2024-05-08 GMT+08:00

查询TOP域名

功能介绍

  • 查询TOP域名。
  • 支持查询90天内的数据。
  • 查询时间跨度不能超过1天。
  • 起始时间和结束时间,左闭右开,必须同时指定。如查询2022-10-24 00:00:00 到 2022-10-25 00:00:00 的数据,表示取 [2022-10-24 00:00:00, 2022-10-25 00:00:00)的统计数据。
  • 起始时间、结束时间必须传整点毫秒级时间戳。
  • 流量类指标单位统一为Byte(字节)、带宽类指标单位统一为bit/s(比特/秒)、请求数类和状态码类指标单位统一为次数。用于查询指定域名、指定统计指标的明细数据。
  • 单租户调用频率:5次/s。

URI

GET /v1/cdn/statistics/top-domain-names

表1 Query参数

参数

是否必选

参数类型

描述

start_time

Long

  • 查询起始时间戳,时间戳应设置需为整点时间戳,设置方式如下:
  • interval为3600时,start_time设置为整小时时刻点,如:1631239200000(对应2021-09-10 10:00:00)
  • interval为86400时,start_time设置为东8区零点时刻点,如:1631203200000(对应2021-09-10 00:00:00)

end_time

Long

  • 查询结束时间戳,时间戳应设置需为整点时间戳,设置方式如下:
  • interval为3600时,end_time设置为整小时时刻点,如:1631325600000(对应2021-09-11 10:00:00)
  • interval为86400时,end_time设置为东8区零点时刻点,如:1631376000000(对应2021-09-12 00:00:00)

stat_type

String

  • 统计类型
  • 目前只支持bw(带宽),flux(流量),req_num(请求总数)

service_area

String

服务区域:mainland_china(默认)、outside_mainland_china,当查询回源类指标时该参数无效。

limit

Integer

top域名查询数量,默认为20,最大为500,最小为0

enterprise_project_id

String

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

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

top_domain_names

Array of Map<String,Object> objects

top域名信息

状态码: default

表3 响应Body参数

参数

参数类型

描述

error

ErrMsg object

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

表4 ErrMsg

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

GET  https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/top-domain-names?start_time=1667030400000&end_time_1667116800000&stat_type=bw&service_area=mainland_china&limit=100&enterprise_project_id=all

响应示例

{
  "top_domain_names": [
    {
      "domain_name": "www.test1.com",
      "flux": 10000000
    },
    {
      "domain_name": "www.test2.com",
      "flux": 20000000
    },
    {
      "domain_name": "www.test3.com",
      "flux": 30000000
    }
  ]
}

状态码

状态码

描述

200

正常响应

default

异常响应

错误码

请参见错误码