tencent cloud

Query Task API
Download PDF
Last updated: 2026-01-07 14:28:00
Query Task API
Last updated: 2026-01-07 14:28:00
Download PDF

Description

Used for querying task execution status duration.
Note:
Used to query the execution status of media library-level time-consuming tasks (currently only supports querying the status of tasks that clear historical versions).
Only tasks completed within the last 30 days can be queried; earlier tasks cannot be queried.

Request

Request Example

GET /api/v1/task/{LibraryId}/{SpaceId}/{TaskIdList}?access_token={AccessToken}&user_id={UserId}

Request Parameter

Request parameters.
Description
Type
Required or Not
LibraryId
Media Library ID, obtained after creating a media library in the media hosting console, see create media library
String
Yes
SpaceId
Space ID, you must specify this parameter. If the media library is in single-tenant mode, this parameter is fixed as hyphen (-).
String
No
TaskIdList
Task ID list, separated by commas, such as 10 or 10,12,13, fill in according to the actual task.
String
Yes
AccessToken
Access token, please see Generate access token
String
Yes
UserId
User identity recognition is used to temporarily assign user identity when the access token has admin permission and user identity recognition is empty during the access token request. For details, see Generate Access Token API
String
No

Request Body

This request does not have a request body.

Response

Response code

Successful retrieval, HTTP 200 OK returned.

Response Body

application/json
Response body example:
[
  {
      "taskId": 10,
      "status": 200,
      "result": {      
          "convertFrom": [          
              "foo",               
              "bar",  
              "test.docx"|
          ],
          "path": [ 
              "foo",               
              "ba_1x1",           
              "test.pdf"
          ],       
          "srcInode": "17abb6£dc6626£4900063£aed543e056" ,
          "dstInode": "10820£030bc92a76000640ca0a4ab©d&"|
      }
]
Response body field description:
Response Parameters
Description
Type
taskId
Task ID
Int
status
Task status code, including the following statuses:
202: Task in progress.
200: Task successfully completed with returned results in the result field.
204: Task successfully completed with no returned results.
500: Task execution failed.
Int
result
Returned results upon successful task completion
Object
The result contains the following parameters:
Response Parameters
Description
Type
convertFrom
conversion path
List
path
Path
List
srcInode
Source node
String
dstInode
Target node
String

Error Codes

This request operation has no special error messages. For common error messages, see Error Codes.


Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback