查询在线直播流数量 -

使用说明

先获取主播流域名，再调用本接口获取直播流的实时在线原始流和转码流流数信息。调用接口返回的视频编码格式为h264和h265。

QPS限制

本接口的单用户QPS限制为1次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLiveStreamCount	系统规定参数。取值：DescribeLiveStreamCount。
DomainName	String	是	example.com	主播流域名。

返回数据

名称	类型	示例值	描述
RequestId	String	FCFFE4A4-F34F-4EEF-B401-36A01689AFBC	请求ID。
StreamCountInfos	Array of StreamCountInfo		流信息统计内容。
StreamCountInfo
Type	String	raw	实时流类型。取值： raw：原始流。 trans：转码流。
Count	Long	3	在线流数量。
Limit	Long	10	并发推流数量限制，只有白名单用户才显示。
StreamCountDetails	Array of StreamCountDetail		流统计信息详情。
StreamCountDetail
VideoDataRate	Long	390	视频码率，该字段只有转码流数量统计时才有。
Format	String	h264	视频编码格式。取值： h264。 h265。
Count	Long	2	在线流数量。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeLiveStreamCountResponse>
    <RequestId>FCFFE4A4-F34F-4EEF-B401-36A01689AFBC</RequestId>
    <StreamCountInfos>
        <Type>raw</Type>
        <Count>3</Count>
        <Limit>10</Limit>
        <StreamCountDetails>
            <VideoDataRate>390</VideoDataRate>
            <Format>h264</Format>
            <Count>2</Count>
        </StreamCountDetails>
    </StreamCountInfos>
</DescribeLiveStreamCountResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "FCFFE4A4-F34F-4EEF-B401-36A01689AFBC",
  "StreamCountInfos" : [ {
    "Type" : "raw",
    "Count" : 3,
    "Limit" : 10,
    "StreamCountDetails" : [ {
      "VideoDataRate" : 390,
      "Format" : "h264",
      "Count" : 2
    } ]
  } ]
}

错误码

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