指定した非同期リクエストの進行状況を照会します。
Action | String | はい | インターフェイス名、値: DescribeTasks。 |
RegionId | String | はい | リージョン ID。リージョン ID については、「DescribeRegion」を参照してください。 |
TaskAction | String | いいえ | 照会された指定のアクション。オプション値:
|
TaskIds | String | いいえ | タスク ID。最大 100 個のタスク ID を使用できます。カンマで区切って指定します。 |
TaskStatus | String | いいえ | タスクのステータス。オプション値:
Finished とProcessing ステータスでタスクを照会することができ、リクエスト内では他の値は無視されます。
|
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 | 現在のページに含まれる項目の数 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=DescribeTasks
&RegionId=cn-hangzhou
&<Common Request Parameters>
戻り値の例
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エラー・センターを参照してください。
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 は存在しません。 |