文档首页/ 视频直播 Live/ 云直播API参考/ 历史API/ 流管理/ 查询直播加速的带宽数据
更新时间：2024-12-05 GMT+08:00
查看PDF
分享

查询直播加速的带宽数据

功能介绍

查询直播加速的播流域名网络带宽监控数据。

当前页面接口为历史版本API，仅供查询部署在旧版视频直播服务上的域名相关数据。此API未来可能停止维护，建议您使用新版视频直播统计API。您也可以通过视频直播控制台使用新版直播统计功能，具体请参见直播统计。

调试

您可以在API Explorer中调试该接口。

URI

GET /v1/{project_id}/stream/bandwidth

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方法请参考获取项目ID。
表2 Query参数

参数

是否必选

参数类型

描述

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

带宽信息
表5 BandwidthInfo

参数

参数类型

描述

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

查询直播加速的带宽数据失败

错误码

请参见错误码。

父主题： 流管理

相关文档