調用DescribeTasks查詢一個或多個異步請求的進度。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
PageNumber | integer | 否 | 查詢結果的頁碼。 起始值:1。 默認值:1。 | 1 |
PageSize | integer | 否 | 分頁查詢時設置的每頁記錄數。 最大值:100。 默認值:10。 | 10 |
RegionId | string | 是 | 地域 ID。您可以調用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
TaskIds | string | 否 | 任務 ID。單次最多支持指定 100 個,ID 之間使用半角逗號(,)分隔。 | t-bp1hvgwromzv32iq****,t-bp179lofu2pv768w**** |
TaskAction | string | 否 | 任務操作的接口名稱。取值范圍:
| ImportImage |
TaskStatus | string | 否 | 任務狀態。取值范圍:
默認值:無。 說明
只支持查詢狀態為 Finished、Processing 和 Failed 的任務,填入其他取值將不會生效。
| Finished |
StartTime | string | 否 | 按創建時間查詢,創建時間區間的起始點。按照ISO 8601標準表示,并需要使用 UTC +0 時間,格式為 yyyy-MM-ddTHH:mm:ssZ。 | 2020-11-23T15:10:00Z |
EndTime | string | 否 | 按創建時間查詢,創建時間區間的終止點。按照ISO 8601標準表示,并需要使用 UTC +0 時間,格式為 yyyy-MM-ddTHH:mm:ssZ。 | 2020-11-23T15:16:00Z |
ResourceIds | array | 否 | 資源 ID。N 的取值范圍:1~100。 | |
string | 否 | 任務關聯的資源 ID。N 的取值范圍:1~100。
| m-bp1i8huqm5u7**** |
返回參數
示例
正常返回示例
JSON
格式
{
"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****"
}
]
}
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
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. | 指定的地域 ID 不存在。 |
訪問錯誤中心查看更多錯誤碼。