查询直播加速的流量数据
功能介绍
查询直播加速的播流域名网络流量监控数据。
当前页面接口为历史版本API,仅供查询部署在旧版视频直播服务上的域名相关数据。此API未来可能停止维护,建议您使用新版视频直播统计API。您也可以通过视频直播控制台使用新版直播统计功能,具体请参见直播统计。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/stream/traffic
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
查询结果的总元素数量 |
|
traffic_info |
Array of TrafficInfo objects |
流量信息 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
traffic |
Integer |
采样周期内的总流量,单位:byte |
|
timestamp |
String |
流量数据采样周期起始时刻,UTC时间,格式:yyyy-MM-ddTHH:mm:ssZ |
状态码: 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误描述 |
请求示例
GET https://{endpoint}/v1/{project_id}/stream/traffic?domain=play.example.huawei.com
响应示例
状态码: 200
查询直播加速的流量数据成功
{
"total" : 1,
"traffic_info" : [ {
"traffic" : 1024,
"timestamp" : "2018-05-19T21:10:15Z"
} ]
}
状态码: 400
查询直播加速的流量数据失败
{
"error_code" : "LIVE.100011001",
"error_msg" : "Request Illegal"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询直播加速的流量数据成功 |
|
400 |
查询直播加速的流量数据失败 |
错误码
请参见错误码。