You can call the GetMPUTaskStatus to obtain the status of the bypass transfer task.

Usage notes

Before you call this operation, you must have called the StartMpuTask to start the bypass to push task.

QPS limits

The single-user QPS of this operation is limited to 4000 times per minute. If the number of the calls per second exceeds the limit, throttling is triggered. This may affect your business. We recommend that you take note of the limit when you call this operation. For more information, 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 GetMPUTaskStatus

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

AppId String Yes yourAppId

The ID of the application. Only flyer IDs are supported.

TaskId String Yes yourTaskId

The ID of the task. Only Flyer IDs are supported, which are the same as the StartMpuTask input parameter TaskId.

Response parameters

Parameter Type Example Description
Status Integer 0

The status ID of the bypass push task.

  • 0: Wait for the channel to start.
    Note If the task is not started within 30 days, the task will automatically stop.
  • 1: The task is running.
  • 2: The task is stopped.
  • 3: The user stops the task.
  • 4: The channel is stopped.
  • 5: Alibaba Cloud Content Delivery Network network issues, live streaming stops.
  • 6: The live streaming is stopped due to a problem with the live URL.
RequestId String 760bad53276431c499e30dc36f6b26be

The ID of the request.

Examples

Sample requests

https://rtc.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

HttpCode Error code Error message Description
400 InvalidTask.IDError taskid is invalid Invalid task with ID error
404 InvalidTask.NotFound no such task The task does not exist.

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