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

Note This operation can be called up to once per second.

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 streaming domain or ingest 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.