Queries the progress of one or more asynchronous requests.
Operation description
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
PageNumber | integer | No | The number of the page to return. Page start from page 1. Default value: 1. | 1 |
PageSize | integer | No | The number of entries to return on each page. Maximum value: 100. Default value: 10. | 10 |
RegionId | string | Yes | The region ID of the task. You can call the DescribeRegions operation to query the most recent region list. | cn-hangzhou |
TaskIds | string | No | The ID of the task. You can specify up to 100 task IDs at a time. Separate the task IDs with commas (,). | t-bp1hvgwromzv32iq****,t-bp179lofu2pv768w**** |
TaskAction | string | No | The name of the operation that generates the task. Valid values:
| ImportImage |
TaskStatus | string | No | The state of the task. Valid values:
This parameter is empty by default. Note
The system only retrieves tasks in the Finished, Processing, and Failed states and ignores other values.
| Finished |
StartTime | string | No | The start point of the time period for which to query created tasks. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC. | 2020-11-23T15:10:00Z |
EndTime | string | No | The end point of the time period for which to query created tasks. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC. | 2020-11-23T15:16:00Z |
ResourceIds | array | No | The ID of resource N that is associated with the task. Valid values of N: 1 to 100.
| |
string | No | The ID of resource N that is associated with the task. Valid values of N: 1 to 100.
| m-bp1i8huqm5u7**** |
Response parameters
Examples
Sample success responses
JSON
format
{
"PageSize": 10,
"PageNumber": 1,
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"TotalCount": 1,
"RegionId": "cn-hangzhou",
"TaskSet": {
"Task": [
{
"CreationTime": "2020-11-24T12:50Z",
"TaskStatus": "Finished",
"FinishedTime": "2020-11-24T12:50Z",
"SupportCancel": "true",
"TaskId": "t-bp1hvgwromzv32iq****",
"TaskAction": "ImportImage",
"ResourceId": "m-bp1i8huqm5u7****"
}
]
}
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | MissingParameter | An input parameter "RegionId" that is mandatory for processing the request is not supplied. | - |
400 | InvalidRegionId.NotFound | The specified RegionId does not exist. | The specified region ID does not exist. |
For a list of error codes, visit the Service error codes.