edit-icon download-icon

DescribeTasks

最終更新日: Jun 28, 2018

指定した非同期リクエストの進行状況を照会します。

リクエストパラメータ

名前 必須かどうか 説明
Action String はい インターフェイス名、値: DescribeTasks。
RegionId String はい リージョン ID。リージョン ID については、「DescribeRegion」を参照してください。
TaskAction String いいえ 照会された指定のアクション。
オプション値:
TaskIds String いいえ タスク ID。最大 100 個のタスク ID を使用できます。カンマで区切って指定します。
TaskStatus String いいえ タスクのステータス。
オプション値:
  • Finished
  • Processing
  • Pending
  • Deleted
  • Paused
デフォルト値: なし
現在、 FinishedProcessingステータスでタスクを照会することができ、リクエスト内では他の値は無視されます。
StartTime String いいえ 作成時刻 (作成が開始した時刻) を使用して照会します。時刻は ISO8601 標準で指定される形式で表示され、UTC 時間が使用されます。YYYY-MM-DDThh:mmZ の形式。
EndTime String いいえ 作成時刻 (作成が終了した時刻) を使用して照会します。時刻は ISO8601標準で指定される形式で表示され、UTC 時間が使用されます。YYYY-MM-DDThh:mmZ の形式。
PageNumber Integer いいえ 照会結果のページ番号。初期値: 1、デフォルト値: 1
PageSize Integer いいえ ページネーション照会で設定する各ページの行数。最大値: 100、デフォルト値: 10

レスポンスパラメータ

名前 説明
TaskSet TaskType タスクセット
RegionId String リージョン ID。
TotalCount Integer リストに含まれる項目の数
PageNumber Integer 現在のページ番号
PageSize Integer 現在のページに含まれる項目の数

リクエストの例

  1. https://ecs.aliyuncs.com/?Action=DescribeTasks
  2. &RegionId=cn-hangzhou
  3. &<Common Request Parameters>

戻り値の例

XML 形式

  1. <DescribeTasksResponse>
  2. <PageNumber>1</PageNumber>
  3. <TotalCount>2</TotalCount>
  4. <PageSize>2</PageSize>
  5. <RegionId>cn-hangzhou</RegionId>
  6. <RequestId>E5C82807-5588-4661-9A96-350B206A7623</RequestId>
  7. <TaskSet>
  8. <Task>
  9. <CreationTime>2015-11-24T12:50Z</CreationTime>
  10. <FinishedTime>2015-11-24T12:50Z</FinishedTime>
  11. <SupportCancel>true</SupportCancel>
  12. <TaskAction>IMPORT_IMAGE</TaskAction>
  13. <TaskStatus>Finished</TaskStatus>
  14. <TaskId>t-23mo8zf9w</TaskId>
  15. </Task>
  16. <Task>
  17. <CreationTime>2015-11-23T15:10Z</CreationTime>
  18. <FinishedTime>2015-11-23T15:16Z</FinishedTime>
  19. <SupportCancel>true</SupportCancel>
  20. <TaskAction>IMPORT_IMAGE</TaskAction>
  21. <TaskStatus>Finished</TaskStatus>
  22. <TaskId>t-23sgu0dyj</TaskId>
  23. </Task>
  24. </TaskSet>
  25. </DescribeTasksResponse>

JSON 形式

  1. {
  2. "PageNumber": 1,
  3. "TotalCount": 2,
  4. "PageSize": 2,
  5. "RegionId": "cn-hangzhou",
  6. "RequestId": "F746C690-D9EA-4F87-AF31-8E1910FAB541",
  7. "TaskSet": {
  8. "Task": [
  9. {
  10. "CreationTime": "2015-11-24T12:50Z",
  11. "FinishedTime": "2015-11-24T12:50Z",
  12. "SupportCancel": true,
  13. "TaskAction": "ImportImage",
  14. "TaskStatus": "Finished",
  15. "TaskId": "t-23mo8zf9w"
  16. },
  17. {
  18. "CreationTime": "2015-11-23T15:10Z",
  19. "FinishedTime": "2015-11-23T15:16Z",
  20. "SupportCancel": true,
  21. "TaskAction": "ImportImage",
  22. "TaskStatus": "Finished",
  23. "TaskId": "t-23sgu0dyj"
  24. }
  25. ]
  26. }
  27. }

エラーコード

次のエラーコードは、このインタフェースに固有のものです。より多くのエラーコードについては、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 は存在しません。