更新时间:2024-03-27 GMT+08:00
分享

查询域名统计数据

功能介绍

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

表1 Query参数

参数

是否必选

参数类型

描述

action

String

  • 动作名称,可选summary、detail。
  • summary:查询汇总数据
  • detail:查询数据详情。

start_time

Long

  • 查询起始时间戳,需与结束时间戳同时指定,左闭右开,设置方式如下:
  • interval为300时,start_time设置为整5分钟时刻点,如:1631240100000(对应2021-09-10 10:15:00)
  • 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为300时,end_time设置为整5分钟时刻点,如:1631243700000(对应2021-09-10 11:15:00)
  • interval为3600时,end_time设置为整小时时刻点,如:1631325600000(对应2021-09-11 10:00:00)
  • interval为86400时,end_time设置为东8区零点时刻点,如:1631376000000(对应2021-09-12 00:00:00)

domain_name

String

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

stat_type

String

  • 网络资源消耗:
    • bw(带宽)
    • flux(流量)
    • bs_bw(回源带宽)
    • bs_flux(回源流量)
  • 访问情况
    • req_num(请求总数)
    • hit_num(请求命中次数)
    • bs_num(回源总数)
    • bs_fail_num(回源失败数)
    • hit_flux(命中流量)
  • HTTP状态码(组合指标)
    • http_code_2xx(状态码汇总2xx)
    • http_code_3xx(状态码汇总3xx)
    • http_code_4xx(状态码汇总4xx)
    • http_code_5xx(状态码汇总5xx)
    • bs_http_code_2xx(回源状态码汇总2xx)
    • bs_http_code_3xx(回源状态码汇总3xx)
    • bs_http_code_4xx(回源状态码汇总4xx)
    • bs_http_code_5xx(回源状态码汇总5xx)
    • status_code_2xx(状态码详情2xx)
    • status_code_3xx(状态码详情3xx)
    • status_code_4xx(状态码详情4xx)
    • status_code_5xx(状态码详情5xx)
    • bs_status_code_2xx(回源状态码详情2xx)
    • bs_status_code_3xx(回源状态码详情3xx)
    • bs_status_code_4xx(回源状态码详情4xx)
    • bs_status_code_5xx(回源状态码详情5xx)
    • status_code和bs_status_code不能一起查询

interval

Long

  • 查询时间间隔,单位:秒,取值说明:
  • 300(5分钟):最大查询跨度2天
  • 3600(1小时):最大查询跨度7天
  • 86400(1天):最大查询跨度31天
  • 如果不传,默认取对应时间跨度的最小间隔。

group_by

String

数据分组方式,可选domain,默认不分组

service_area

String

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

enterprise_project_id

String

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

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

result

Map<String,Object>

按指定的分组方式组织的数据

状态码: default

表3 响应Body参数

参数

参数类型

描述

error

ErrMsg object

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

表4 ErrMsg

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

  • 不分组详情数据
    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

异常响应

错误码

请参见错误码

分享:

    相关文档

    相关产品