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
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:
|
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:
|
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.