Queries the status of a single stream in real time.

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 DescribeLiveStreamState

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

AppName String Yes testApp

The name of the application to which the live stream belongs.

DomainName String Yes www.example.com

The ingest domain or streaming domain.

StreamName String Yes testStream

The name of the live stream.

RegionId String No cn-shanghai

The ID of the region.

Response parameters

Parameter Type Example Description
RequestId String CE6CD79D-0A98-1F22-A15F-FADA74DF2729

The ID of the request.

StreamState String online

The status of the stream. Valid values:

  • online: indicates that the stream is being ingested.
  • offline: indicates that stream ingest failed or ended. The specific status is returned based on the stream ingest callback.
  • forbidden: indicates that stream ingest is disabled.
Type String push

The type of stream ingest. Valid values:

  • push: stream pushing.
  • pull: triggered stream pulling.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=DescribeLiveStreamState
&AppName=testApp
&DomainName=www.example.com
&StreamName=testStream
&<Common request parameters>

Sample success responses

XML format

<StreamState>online</StreamState>
<Type>push</Type>
<RequestId>CE6CD79D-0A98-1F22-A15F-FADA74DF2729</RequestId>

JSON format

null

Error codes

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