All Products
Search
Document Center

:GetMPUTaskStatus

最終更新日:Mar 04, 2024

Queries the status of a stream relay task.

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.