GetMPUTaskStatus - ApsaraVideo Live - Alibaba Cloud Documentation Center

Usage notes

Make sure that a stream relay task is started before you call this operation. You can call the StartLiveMPUTask operation to start a stream relay task.

QPS limit

You can call this operation up to 10 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation.

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	GetMPUTaskStatus	The operation that you want to perform. Set the value to GetMPUTaskStatus.
AppId	String	Yes	yourAppId	The application ID. You can specify only one application ID.
TaskId	String	Yes	yourTaskId	The task ID. You can specify only one task ID. The value must be the same as the task ID specified by the TaskId parameter in your call of the StartLiveMPUTask operation.

Response parameters

Parameter

Type

Example

Description

RequestId

String

760bad53276431c499e30dc36f6b26be

The request ID.

Status

Integer

0

The ID of the status of the stream relay task.

0: indicates that you need to wait for the channel to start.

Note If the task is not started within 30 days, the task is automatically stopped.

1: indicates that the task is running.
2: indicates that the task is stopped.
3: indicates that the user stops the task.
4: indicates that the channel is stopped.
5: indicates that live streaming is stopped due to a content delivery network issue.
6: indicates that live streaming is stopped due to a streaming URL issue.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=GetMPUTaskStatus
&AppId=yourAppId
&TaskId=yourTaskId
&<Common request parameters>

Sample success responses

XML format

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

<GetMPUTaskStatusResponse>
    <RequestId>760bad53276431c499e30dc36f6b26be</RequestId>
    <Status>0</Status>
</GetMPUTaskStatusResponse>

JSON format

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

{
  "RequestId" : "760bad53276431c499e30dc36f6b26be",
  "Status" : 0
}

Error codes

For a list of error codes, see Service error codes.