查询推流信息接口（ListRealtimePubStreamsInfo）

接口说明

• 用来查询域名下某应用或某条流的推流信息
• 限制访问频率：50次/分钟
• 调用方式：HTTP GET
• 数据粒度：100s

请求参数

参数名	类型	是否必须	描述
Action	String	Y	操作接口名，取值：ListRealtimePubStreamsInfo
Version	String	Y	版本号，取值：2017-01-01
UniqueName	String	Y	域名空间
App	String	Y	应用名
Pubdomain	String	Y	推流域名
Stream	String	N	流名
OrderTime	Int	N	排序类型,0：按推流开始时间降序排列，1：按推流开始时间升序排列
Marker	Int	N	起始游标，默认为0。 0代表第1页的数据，以此类推
Limit	Int	N	每页返回的记录数，默认1000。单页最多返回5000条数据

返回参数

参数名	类型	描述
UniqueName	String	域名空间
App	String	应用名
Pubdomain	String	推流域名
Stream	String	流名
Count	Int	本页返回的记录数
Marker	Int	起始游标，默认为0。 0代表第1页的数据，以此类推
OrderTime	Int	排序类型,0：按推流开始时间降序排列，1：按推流开始时间升序排列
Total	Int	符合查询条件的总记录数
ClientIP	String	推流客户端IP
Width	String	视频宽度
Height	String	视频高度
FrameRate	String	视频理论帧率
Curfps	Int	视频实时帧率
Curbitrate	Int	视频码率/B
BwInAudio	String	音频码率/B
SampleRate	String	音频采样率/Hz
BwReal	String	总真实码率/B
BwIn	String	总理论码率/B
UpdateTime	Int	流信息采集UTC时间
PubTime	Int	开始推流的UTC时间
RetCode	Int	响应码 0成功 其他失败
RetMsg	String	响应信息描述

请求示例

GET /?Action=ListRealtimePubStreamsInfo&Version=2017-01-01&UniqueName=xxx&App=live&Pubdomain=xxx.xxx.com&Marker=0&Limit=2&OrderTime=0 HTTP/1.1 
Content-Type: application/json
X-Amz-Date: YOURDATE
Authorization: AWS4-HMAC-SHA256 Credential=YOURAK/YYYYMMDD/cn-beijing-6/kls/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-date, Signature=SIG
Host: kls.api.ksyun.com

返回示例

{
  "Data": {
    "App": "live",
    "Count": 1,
    "Marker": 0,
    "OrderTime": 0,
    "Pubdomain": "xxx.xxx.com",
    "Result": [
      {
        "BwIn": "52666",
        "BwInAudio": "20814",
        "BwReal": "52227",
        "Clientip": "114.255.44.132",
        "Curbitrate": 52666,
        "Curfps": 31,
        "FrameRate": "30",
        "Height": "614",
        "Pubtime": 1491033051,
        "SampleRate": "44100",
        "Stream": "yh668",
        "UpdateTime": 1491036296,
        "Width": "1092"
      }
    ],
    "RetCode": 0,
    "RetMsg": "success",
    "Total": 1,
    "UniqueName": "xxx"
  }
}

错误码

为了帮您快速定位问题，云直播将错误码集中归类，请到错误码中心查看详情。