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

請求參數

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

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

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不存在。