Query the status of a media task by task ID.
Note
Valid task statuses: ["submitted","TERMINATED","RUNNING","FINISHED","EXITED"]
Request Method (cURL)
curl --location 'https://example.com/media-intelligence/openapi/v1/workflow-tasks/getTaskStatus?taskId=xxx' \
--header 'X-Request-Id: db160925-0b58-4609-bc6e-08cdf12bf2e6' \
--header 'X-Access-Key: 5017114*******' \
--header 'X-Request-Sign: 7894db2a4*******c23976d6d42c93e' \
--header 'X-Request-Timestamp: 1736162679922'Request Parameters
|
Name |
Location |
Type |
Required |
Description |
|
taskId |
URL |
String |
Yes |
Task ID |
Response Parameters
|
Name |
Type |
Example |
Description |
|
data.taskName |
String |
media_task_1 |
Task name |
|
data.taskId |
String |
30BA59AE-2459-4E1A-8154-A844BD0A2FC0 |
Task ID |
|
data.status |
String |
["SUBMITED","TERMINATED","RUNNING","FINISHED","EXITED"] |
Task status |
|
data.traceInfo |
String |
"Exception: oss Download timeout" |
Exception details if the task is abnormal. |
Error Codes
|
Error Code |
Description |
|
ERR_INTERNAL_SERVER_ERROR |
Internal server error |
|
ERR_INVALID_PARAMETER |
Missing taskId parameter |
Timeout Handling
|
Timeout |
Timeout Policy |
|
3s |
On timeout, terminate the previous request and retry with the same parameters. |
Sample Response
{
"success": true,
"errorCode": null,
"errorMsg": null,
"traceId": "30BA59AE-2459-4E1A-8154-A844BD0A2FC0",
"data": {
"taskName": "txxxn",
"taskId": "fbb8acbe-d680-4c9f-8f3d-3e8733e02199",
"status": "FINISHED",
"traceInfo": ""
}
}