Queries the number of online original streams and transcoded streams among live streams.

Usage note

This operation is applicable to the main streaming domains.

QPS limit

A single user can perform a maximum of 1 queries per second. Throttling is triggered when the number of calls per second exceeds the QPS limit. The throttling may affect your business. Thus, we recommend that you observe the QPS limit on this operation. For more information about what a single user means and the QPS details, see QPS limit on an API operation in ApsaraVideo Live.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeLiveStreamCount

The operation that you want to perform. Set the value to DescribeLiveStreamCount.

DomainName String Yes example.com

The main streaming domain.

Response parameters

Parameter Type Example Description
RequestId String FCFFE4A4-F34F-4EEF-B401-36A01689AFBC

The ID of the request.

StreamCountInfos Array of StreamCountInfo

The statistics of the live streams.

StreamCountInfo
Count Long 3

The number of online streams.

Limit Long 10

The maximum number of concurrent ingest streams. This parameter is available only for users in the whitelist.

StreamCountDetails Array of StreamCountDetail

The information about the live streams.

StreamCountDetail
Count Long 2

The number of online streams.

Format String h264

The video encoding format. Valid values:

  • h264
  • h265
VideoDataRate Long 390

The video bitrate. This parameter is available only for transcoded streams.

Type String raw

The type of the live stream. Valid values:

  • raw: an original stream.
  • trans: a transcoded stream.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=DescribeLiveStreamCount
&DomainName=example.com
&<Common request parameters>

Sample success responses

XML format

<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 format

{
        "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
                                }]
                        }
                }]
        }
}

Error codes

For a list of error codes, visit the API Error Center.