Skip to main content

DescribeTasks

Description

call DescribeTasks to query the progress of one or more asynchronous requests.

Request Method

POST

Request Path

/apsara/route/Ecs/DescribeTasks

Request Parameters Common Parameters

NameLocationTypeRequiredSample valueDescription
PageSizeBODYintegerNo2the number of records per page set during paging query, the maximum value is 100 rows, and the default value is 10.
TaskIdsBODYstringNot-bp1hvgwromzv32iq****,t-bp179lofu2pv768w****task ID, up to 100 tasks can be specified at a time, and the IDs are separated by half-width commas (,).
EndTimeBODYstringNo2015-11-23T15:16:00Zquery by creation time to create the end point of the time interval. According to the ISO8601 standard, UTC +0 time is required in the format of yyyy-MM-ddTHH:mm:ssZ.
PageNumberBODYintegerNo1the page number of the query result, the starting value is 1, and the default value is 1.
regionIdBODYstringYesNo sample value for this parameter.region id
TaskActionBODYstringNoImportImagethe interface name of the task operation. Value range: ImportImage: import image. ExportImage: 'export' image.
StartTimeBODYstringNo2015-11-23T15:10:00Zquery by the creation time to create the starting point of the time interval. According to the ISO8601 standard, UTC +0 time is required in the format of yyyy-MM-ddTHH:mm:ssZ.
RegionIdBODYstringYescn-qingdao-env17-d01region ID. You can call the DescribeRegions to view the latest Alibaba Cloud region list.
TaskStatusBODYstringNoFinishedtask status. Value range: Finished: completed. Processing: running. Pending: Waiting for execution. Deleted: canceled. Paused: Pause. Default value: None.
versionBODYstringNo2016-01-01version of api

Return data

NameTypeSample valueDescription
RequestIDstring1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DCRequest id

Example

Successful Response example

{
"RequestID":"1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DC"
}

Failed Response example

{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}

}