文档首页/ 内容分发网络 CDN/ API参考/ 历史API/ 统计分析/ 查询域名带宽峰值类数据
更新时间:2024-05-08 GMT+08:00

查询域名带宽峰值类数据

功能介绍

  • 查询域名带宽峰值类数据。
  • 支持查询90天内的数据。
  • 查询时间跨度不能超过31天。
  • 起始时间和结束时间,左闭右开。如查询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(比特/秒)、峰值类指标单位统一为bps(比特率),请求数类和状态码类指标单位统一为次数。用于查询指定域名、指定统计指标的明细数据。
  • 单租户调用频率:2次/s。

URI

GET /v1.0/cdn/statistics/bandwidth-calc

表1 Query参数

参数

是否必选

参数类型

描述

start_time

Long

  • 查询起始时间戳,时间戳应设置需为整5分钟,设置方式如下:
  • 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

  • 查询结束时间戳,时间戳应设置需为整5分钟,设置方式如下:
  • 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表示查询名下全部域名

service_area

String

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

enterprise_project_id

String

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

calc_type

String

查询类别,目前支持bw_95(95峰值带宽),bw_peak(日峰值月平均带宽),bw_95_average(95月平均带宽)

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

bandwidth_calc

Map<String,Object>

95峰值,日峰值月平均线信息

状态码: 400

表3 响应Body参数

参数

参数类型

描述

error

ErrMsg object

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

表4 ErrMsg

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

GET  https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/bandwidth_calc?start_time=1667030400000&end_time_1667116800000&domain_name=www.test1.com&service_area=mainland_china&enterprise_project_id=all&calc_type=bw_peak

响应示例

{
  "bandwidth_calc": [
    {
      "value": 10000000,
      "calc_type": "bw_peak"
    },
    {
      "value": 20000000,
      "calc_type": "bw_peak"
    }
  ]
}

状态码

状态码

描述

200

成功响应

400

错误响应

错误码

请参见错误码