查詢指定的非同步請求的進度。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:DescribeTasks
RegionId String 地域ID。您可以調用DescribeRegions查看最新的阿里雲地域列表。
TaskAction String 任務操作的介面名稱。取值範圍:
TaskIds String 任務ID,單次最多支援指定100個,ID之間使用半形逗號(,)分隔。
TaskStatus String 任務狀態。取值範圍:
  • Finished:已完成
  • Processing:運行中
  • Waiting:多任務排隊中
  • Deleted:已取消
  • Paused:暫停
預設值:無

目前,只支援查詢狀態為FinishedProcessing的任務,填入其他取值將不會生效。

StartTime String 按建立時間查詢,建立時間區間的起始點。按照ISO8601標準表示,並需要使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。
EndTime String 按建立時間查詢,建立時間區間的終止點。按照ISO8601標準表示,並需要使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。
PageNumber Integer 查詢結果的頁碼,起始值為1,預設值為1。
PageSize Integer 分頁查詢時設定的每頁記錄數,最大值100行,預設值為10。

返回參數

名稱 類型 描述
TaskSet TaskType 任務集合
RegionId String 地域ID
TotalCount Integer 列表條條目數
PageNumber Integer 當前頁碼
PageSize Integer 當前分頁包含多少條目

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=DescribeTasks
&RegionId=cn-hangzhou
&<公共請求參數>
返回樣本

XML格式

<DescribeTasksResponse>
  <PageNumber>1</PageNumber>
  <TotalCount>2</TotalCount>
  <PageSize>2</PageSize>
  <RegionId>cn-hangzhou</RegionId>
  <RequestId>E5C82807-5588-4661-9A96-350B206A7623</RequestId>
  <TaskSet>
    <Task>
      <CreationTime>2015-11-24T12:50Z</CreationTime>
      <FinishedTime>2015-11-24T12:50Z</FinishedTime>
      <SupportCancel>true</SupportCancel>
      <TaskAction>IMPORT_IMAGE</TaskAction>
      <TaskStatus>Finished</TaskStatus>
      <TaskId>t-23mo8zf9w</TaskId>
    </Task>
    <Task>
      <CreationTime>2015-11-23T15:10Z</CreationTime>
      <FinishedTime>2015-11-23T15:16Z</FinishedTime>
      <SupportCancel>true</SupportCancel>
      <TaskAction>IMPORT_IMAGE</TaskAction>
      <TaskStatus>Finished</TaskStatus>
      <TaskId>t-23sgu0dyj</TaskId>
    </Task>
  </TaskSet>
</DescribeTasksResponse>

JSON格式

{
    "PageNumber": 1,
    "TotalCount": 2,
    "PageSize": 2,
    "RegionId": "cn-hangzhou",
    "RequestId": "F746C690-D9EA-4F87-AF31-8E1910FAB541",
    "TaskSet": {
        "Task": [
            {
                "CreationTime": "2015-11-24T12:50Z",
                "FinishedTime": "2015-11-24T12:50Z",
                "SupportCancel": true,
                "TaskAction": "ImportImage",
                "TaskStatus": "Finished",
                "TaskId": "t-23mo8zf9w"
            },
            {
                "CreationTime": "2015-11-23T15:10Z",
                "FinishedTime": "2015-11-23T15:16Z",
                "SupportCancel": true,
                "TaskAction": "ImportImage",
                "TaskStatus": "Finished",
                "TaskId": "t-23sgu0dyj"
            }
        ]
    }
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API錯誤中心

錯誤碼 錯誤資訊 HTTP狀態碼 說明
MissingParameter An input parameter “RegionId” that is mandatory for processing the request is not supplied. 400 缺少必填參數RegionId
InvalidRegionId.NotFound The specified region not found. 400 指定的RegionId不存在。