视频直播

产品文档

视频直播

describeLiveStreamTrafficData

描述

查询流量数据

  • 查询某个时间段内的流量数据。
  • 查询1分钟粒度的数据时,时间跨度不超过7天,其他粒度时时间跨度不超过30天

请求方式

GET

请求地址

https://live.jdcloud-api.com/v1/describeLiveStreamTrafficData

请求参数

名称 类型 是否必需 默认值 描述
domainName String False 播放域名,可以通过指定域名查询该域名下产生的带宽数据。
appName String False 推流AppName,将AppName作为查询条件时须指定域名。
streamName String False 流名称
ispName String False 运营商
locationName String False 地域,如beijing,shanghai。多个用逗号分隔
protocolType String False 查询的流协议类型,取值范围:"rtmp,hdl,hls",多个时以逗号分隔
period String False 查询周期,当前取值范围:“oneMin,fiveMin,halfHour,hour,twoHour,sixHour,day,followTime”,分别表示1min,5min,半小时,1小时,2小时,6小时,1天,跟随时间。默认为空,表示fiveMin。当传入followTime时,表示按Endtime-StartTime的周期,只返回一个点
startTime String True 查询起始时间,UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z'
endTime String False 查询截至时间,UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',为空时默认为当前时间

返回参数

名称 类型 描述
result Result
requestId String ruquestId

Result

名称 类型 描述
dataList TrafficStatisticResult[ ]

TrafficStatisticResult

名称 类型 描述
startTime String 时间点
endTime String 时间点
data TrafficStatisticResultData

TrafficStatisticResultData

名称 类型 描述
value Long 流量,单位:Byte

返回码

返回码 描述
200 OK
400 Invalid parameter
401 Authentication failed
404 Not found
500 Internal server error
503 Service unavailable

请求示例

GET

https://live.jdcloud-api.com/v1/describeLiveStreamTrafficData?domainName=xxx
{
    "endTime": "2019-03-27T16:00:00Z", 
    "startTime": "2019-03-26T16:00:00Z"
}

返回示例

{
    "requestId": "bgvmivir54gddpgi764se9f4kfr7ge41", 
    "result": {
        "dataList": [
            {
                "data": {
                    "value": 188486700
                }, 
                "endTime": "2019-03-26T07:31:00Z", 
                "startTime": "2019-03-26T07:30:00Z"
            }, 
            {
                "data": {
                    "value": 376973400
                }, 
                "endTime": "2019-03-26T07:32:00Z", 
                "startTime": "2019-03-26T07:31:00Z"
            }, 
            {
                "data": {
                    "value": 376973400
                }, 
                "endTime": "2019-03-26T07:33:00Z", 
                "startTime": "2019-03-26T07:32:00Z"
            }
        ]
    }
}
更新时间:2019-07-16 18:23:16
feedback