Querying System Task Details
Function
This API is used to query details about asynchronous tasks.
URI
- URI format
GET /v1/{project_id}/system-tasks/{task_id}
- Parameter description
Table 1 URI parameters Parameter
Mandatory
Type
Description
project_id
Yes
String
Project ID. For details about how to obtain a project ID, see Project ID and Account ID.
task_id
Yes
String
Task ID. For details about how to obtain the ID, see the response parameters in Importing a Job.
Request Parameters
Parameter | Mandatory | Type | Description |
---|---|---|---|
workspace | No | String | Workspace ID.
|
Response Parameters
Parameter | Mandatory | Type | Description |
---|---|---|---|
id | Yes | String | Task ID. |
name | Yes | String | Name of the task. |
startTime | Yes | Long | Start time. |
endTime | No | Long | End time. |
lastUpdate | Yes | Long | Time when the task was last updated. |
status | Yes | String | Task status.
|
projectId | No | String | Project ID |
subtasks | No | List<SubTask> | Subtask. For details, see Table 4. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
id | Yes | String | Subtask ID. |
name | Yes | String | Name of the subtask. |
lastUpdate | Yes | Long | Time when the task was last updated. |
status | Yes | String | Task status.
|
taskId | No | String | Task information |
Example Request
Query the task for exporting a job.
GET /v1/b384b9e9ab9b4ee8994c8633aabc9505/systemTasks/008aae2e675d3bcb01675d40ab3f0005
Example Response
- Success response{"endTime": 1544777083000,"id": "008aae2e67abe2ff0167abe3a28f0000","lastUpdate": 1544777083000,"name": "Import the job from obs://aaaaa/job_batch.zip.","projectId": "b384b9e9ab9b4ee8994c8633aabc9505","startTime": 1544777081000,"status": "SUCCESSFUL","subtasks": [{"id": "008aae2e67abe2ff0167abe3a7e70002","lastUpdate": 1544777083000,"name": "Import the job_batch job.","status": "SUCCESSFUL""taskId": "008aae2e675d3bcb01675d40ab3f0005"}]}
- Failure response
HTTP status code 400
{"error_code":"DLF.20810","error_msg":"Task[008aae2e675d3bcb01675d40ab3f0005] does not exist"}
- Function
- URI
- Request Parameters
- Response Parameters
- Example Request
- Example Response