文档首页/ 内容分发网络 CDN/ API参考/ 历史API/ 统计分析/ 查询TOP域名
更新时间：2025-04-25 GMT+08:00
查看PDF
分享

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

异常响应

错误码

请参见错误码。

父主题： 统计分析