# 查询直播加速的带宽数据
#### 功能介绍
查询直播加速的播流域名网络带宽监控数据。
![](https://support.huaweicloud.com/api-live/public_sys-resources/note_3.0-zh-cn.png)
当前页面接口为历史版本API，仅供查询部署在旧版视频直播服务上的域名相关数据。此API未来可能停止维护，建议您使用[新版视频直播统计API](https://support.huaweicloud.com/api-live/ListBandwidthDetail.html)。您也可以通过视频直播控制台使用新版直播统计功能，具体请参见[直播统计](https://support.huaweicloud.com/iLive-live/live_01_0062.html)。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=Live&api=ShowBandwidth)中调试该接口。
#### URI
GET /v1/{project_id}/stream/bandwidth
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID，获取方法请参考[获取项目ID](https://support.huaweicloud.com/api-live/live_03_0023.html)。 |
   
表2Query参数 
| 参数         | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| domain     | 否    | String  | 播放域名，不指定域名表示查询租户所有域名汇总带宽                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| start_time | 否    | String  | 查询起始时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| end_time   | 否    | String  | 查询结束时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ。 - start_time与end_time均不存在时，服务端从最近一个统计周期的数据里查询。  - start_time存在、end_time不存在时，end_time取当前时间。  - start_time不存在、end_time存在时，请求非法。  - 只能查询最近三个月内的数据，start_time和end_time的跨度不能大于30天。   |
| step       | 否    | Integer | 统计周期，单位：分钟                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                      |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token，使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数             | 参数类型                                                                    | 描述         |
|:---|:---|:---|
| total          | Integer                                                                 | 查询结果的总元素数量 |
| bandwidth_info | Array of [BandwidthInfo] objects | 带宽信息       |
   
 表5BandwidthInfo 
| 参数        | 参数类型    | 描述                                         |
|:---|:---|:---|
| bw_bps    | Integer | 带宽峰值，单位：bps                                |
| timestamp | String  | 带宽数据采样周期起始时刻，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ |
   
**状态码： 400**
表6响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误描述 |
   
#### 请求示例
```
GET https://{endpoint}/v1/{project_id}/stream/bandwidth?domain=play.example.huawei.com
```
#### 响应示例
**状态码： 200**
查询直播加速的带宽数据成功
```
{
  "total" : 1,
  "bandwidth_info" : [ {
    "bw_bps" : 1024,
    "timestamp" : "2018-05-19T21:10:15Z"
  } ]
}
```
**状态码： 400**
查询直播加速的带宽数据失败
```
{
  "error_code" : "LIVE.100011001",
  "error_msg" : "Request Illegal"
}
```
#### 状态码
| 状态码 | 描述            |
|:---|:---|
| 200 | 查询直播加速的带宽数据成功 |
| 400 | 查询直播加速的带宽数据失败 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-live/ErrorCode.html)。