调用DescribeLiveStreamCount获取直播流的实时在线原始流和转码流流数信息。

说明 调用频率限制1次/秒。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeLiveStreamCount

系统规定参数，取值：DescribeLiveStreamCount。

DomainName String 是 example.com

直播播放域名或推流域名。
RegionId String 否 cn-shanghai

地域ID。默认值为cn-shanghai。

说明

如果传了直播域名DomainName，RegionID要和域名所在直播中心的RegionID保持一致。

不传RegionID的话，就是默认值cn-shanghai，所传直播域名参数DomainName所在直播中心的RegionID不是cn-shanghai的话，会查不到数据。

返回数据

名称 类型 示例值 描述
RequestId String FCFFE4A4-F34F-4EEF-B401-36A01689AFBC

请求ID。
StreamCountInfos Array of StreamCountInfo

流信息统计内容。
StreamCountInfo
Count Long 3

在线流数量。
Limit Long 10

并发推流数量限制，只有白名单用户才显示。
StreamCountDetails Array of StreamCountDetail

流统计信息详情。
StreamCountDetail
Count Long 2

在线流数量。
Format String h264

视频编码格式。取值：

  • h264。
  • h265。
VideoDataRate Long 390

视频码率，该字段只有转码流数量统计时才有。
Type String raw

实时流类型。取值：

  • raw：原始流。
  • trans：转码流。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveStreamCount
&DomainName=example.com
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeLiveStreamCountResponse>
  <RequestId>FCFFE4A4-F34F-4EEF-B401-36A01689AFBC</RequestId>
  <StreamCountInfos>
        <StreamCountInfo>
              <Count>3</Count>
              <Type>raw</Type>
              <StreamCountDetails>
                    <StreamCountDetail>
                          <Format>h264</Format>
                          <Count>2</Count>
                    </StreamCountDetail>
                    <StreamCountDetail>
                          <Format>h265</Format>
                          <Count>1</Count>
                    </StreamCountDetail>
              </StreamCountDetails>
        </StreamCountInfo>
        <StreamCountInfo>
              <Count>3</Count>
              <Type>trans</Type>
              <StreamCountDetails>
                    <StreamCountDetail>
                          <Format>h264</Format>
                          <Count>2</Count>
                          <VideoDataRate>390</VideoDataRate>
                    </StreamCountDetail>
                    <StreamCountDetail>
                          <Format>h265</Format>
                          <Count>1</Count>
                          <VideoDataRate>700</VideoDataRate>
                    </StreamCountDetail>
              </StreamCountDetails>
        </StreamCountInfo>
  </StreamCountInfos>
</DescribeLiveStreamCountResponse>

JSON 格式 

{
        "RequestId": "FCFFE4A4-F34F-4EEF-B401-36A01689AFBC",
        "StreamCountInfos": {
                "StreamCountInfo": [{
                        "Count": 3,
                        "Type": "raw",
                        "StreamCountDetails": {
                                "StreamCountDetail": [{
                                        "Format": "h264",
                                        "Count": 2
                                }, {
                                        "Format": "h265",
                                        "Count": 1
                                }]
                        }
                }, {
                        "Count": 3,
                        "Type": "trans",
                        "StreamCountDetails": {
                                "StreamCountDetail": [{
                                        "Format": "h264",
                                        "Count": 2,
                                        "VideoDataRate": 390
                                }, {
                                        "Format": "h265",
                                        "Count": 1,
                                        "VideoDataRate": 700
                                }]
                        }
                }]
        }
}

错误码

访问错误中心查看更多错误码。