# 查询域名带宽峰值类数据 #### 功能介绍 - 查询域名带宽峰值类数据。 - 支持查询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。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=CDN&api=ShowBandwidthCalc)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### URI GET /v1.0/cdn/statistics/bandwidth-calc 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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\ | 95峰值，日峰值月平均线信息 | **状态码： 400** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrMsg] object | 用于返回具体的错误码和错误消息 | 表4ErrMsg | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 错误响应 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cdn/ErrorCode.html)。