查询直播加速的带宽数据
功能介绍
查询直播加速的播流域名网络带宽监控数据。
当前页面接口为历史版本API，仅供查询部署在旧版视频直播服务上的域名相关数据。此API未来可能停止维护，建议您使用新版视频直播统计API。您也可以通过视频直播控制台使用新版直播统计功能，具体请参见直播统计。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/stream/bandwidth
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目ID，获取方法请参考获取项目ID。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
domain |
否 |
String |
播放域名，不指定域名表示查询租户所有域名汇总带宽 |
start_time |
否 |
String |
查询起始时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ |
end_time |
否 |
String |
查询结束时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ。
|
step |
否 |
Integer |
统计周期，单位：分钟 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token，使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
total |
Integer |
查询结果的总元素数量 |
bandwidth_info |
Array of BandwidthInfo objects |
带宽信息 |
参数 |
参数类型 |
描述 |
|---|---|---|
bw_bps |
Integer |
带宽峰值，单位：bps |
timestamp |
String |
带宽数据采样周期起始时刻，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ |
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
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 |
查询直播加速的带宽数据失败 |
错误码
请参见错误码。
