更新时间:2023-06-13 GMT+08:00

查询网络带宽明细

支持查询90天内的数据。

时间跨度最小支持1小时,最大不超过31天。

最多同时指定100个域名。

起始时间和结束时间需同时指定。开始时间、结束时间必须传毫秒级时间戳。采样间隔<=1小时,需为1小时整时刻点,如2020-07-01 08:00:00、2020-07-01 09:00:00;采样间隔>1小时,需为1天整时刻点,如2020-07-01 00:00:00、2020-07-02 00:00:00。

如果起始时间、结束时间不满足采样间隔的整时刻点,返回数据可能与预期不一致。

功能介绍

查询网络带宽明细。

时间跨度最小支持1小时。

URI

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

请求消息

请求参数

请求参数如表1所示。

表1 请求参数

名称

是否必选

参数类型

描述

start_time

Long

查询起始时间戳(单位:毫秒)。

end_time

Long

查询结束时间戳(单位:毫秒)。

domain_name

String

域名列表,多个域名以逗号(半角)分隔,如:www.test1.com,www.test2.com ,ALL表示查询名下全部域名。

interval

Interger

采样间隔,单位:秒,取值说明:

时间跨度1天:5分钟、1小时、4小时、8小时。

时间跨度2~7天:5分钟、1小时、4小时、8小时、1天。

时间跨度8~31天:4小时、8小时、1天。

如果不传,默认取对应时间跨度的最小间隔。

如果需要传,则换算成秒。

enterprise_project_id

String

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

请求示例

请求路径示例

GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/bandwidth-detail?start_time=1498838400000&end_time=1502380500000&domain_name=www.example.com&interval=300&enterprise_project_id=0

响应消息

响应参数

响应参数如表2所示。

表2 响应参数

名称

参数类型

描述

bandwidth_detail

Object

详情数据对象。详细说明见表3

bandwidth参数说明

bandwidth参数说明如表3所示。

表3 bandwidth参数说明

名称

参数类型

描述

start_time

Interger

查询起始时间戳(单位:毫秒)。

end_time

Interger

查询结束时间戳(单位:毫秒)。

stat_type

String

统计类型。

interval

Interger

采样间隔,单位:秒。

values

Array of integers

带宽数据列表,从start_time开始,每采样间隔生成一个采样点,按时间顺序排列(单位:bps)。

响应示例
{
  "bandwidth_detail": {
        "interval": 300,
        "values": [835038583,835038544],
        "start_time": 1498838400000,
        "end_time": 1502380500000,
        "stat_type" : "bw"
   }
}

状态码

状态码请参见状态码

错误码

请参见错误码