Querying Running Tasks
Function
Queries running tasks.
Calling Method
For details, see Calling APIs.
URI
GET /v3/{project_id}/running-tasks
Parameter | Mandatory | Type | Description |
|---|---|---|---|
project_id | Yes | String | Project ID |
Parameter | Mandatory | Type | Description |
|---|---|---|---|
limit | No | Integer | Specifies the number of items displayed per page. Default value: 1000 |
offset | No | Integer | Offset of the first displayed task that is being processed. |
Request Parameters
Parameter | Mandatory | Type | Description |
|---|---|---|---|
X-Auth-Token | Yes | String | User token. Can be obtained by calling the IAM API for obtaining the user token (the value of X-Subject-Token in the response header). |
Response Parameters
Status code: 200
Parameter | Type | Description |
|---|---|---|
total | Integer | Total number of running tasks. |
tasks | Array of RunningTasks objects | List of running tasks. |
Parameter | Type | Description |
|---|---|---|
task_id | String | VM ID. |
operate_type | String | Operation type - FAILED_RESET: reset - FAILED_REPLACE: replace - FAILED_UNBIND: unbind |
task_time | String | Task time |
server_name | String | VM Name |
server_id | String | VM ID. |
keypair_name | String | Key pair name. |
Status code: 400
Parameter | Type | Description |
|---|---|---|
error_code | String | Error Codes |
error_msg | String | Description |
Example Requests
None
Example Responses
Status code: 200
OK
{
"total" : 1,
"tasks" : [ {
"task_id" : "aee8d2fe-5484-4753-9177-5a38dc15546c",
"operate_type" : "RUNNING_RESET",
"task_time" : "1523342130000",
"server_name" : "Test",
"server_id" : "c9aa197b-a6b6-4c33-b3a6-fa0b4ec50006",
"keypair_name" : "KeyPair-xt"
} ]
} Status code: 400
Error response
{
"error_code" : "KPS.XXX",
"error_msg" : "XXX"
} Status Codes
Status Code | Description |
|---|---|
200 | OK |
400 | Error response |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.

