翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ListExecutions
1 つ以上のターゲットデバイスのタスクのステータスを返します。
リクエストの構文
GET /executions?maxResults=maxResults
&nextToken=nextToken
&state=state
&taskId=taskId
HTTP/1.1
URI リクエストパラメータ
リクエストでは、次のURIパラメータを使用します。
- maxResults
-
1 ページあたりにリストするタスクの最大数。
有効範囲: 最小値は 1 です。最大値は 100 です。
- nextToken
-
次ページのタスクに進むページ割りトークン。
長さの制限: 最小長は 1 です。最大長は 1,024 です。
Pattern:
^[a-zA-Z0-9+/=]*$
- state
-
タスクを現在の状態でフィルタリングするために使用される構造。
有効な値:
QUEUED | IN_PROGRESS | CANCELED | FAILED | SUCCEEDED | REJECTED | TIMED_OUT
- taskId
-
タスクの ID。
長さの制限:最小長は 1 です。最大長は 64 文字です。
必須:はい
リクエストボディ
リクエストにリクエスト本文がありません。
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"executions": [
{
"executionId": "string",
"managedDeviceId": "string",
"state": "string",
"taskId": "string"
}
],
"nextToken": "string"
}
レスポンス要素
アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。
次のデータは、 サービスによって JSON 形式で返されます。
- executions
-
実行のリスト。各実行には、タスク ID、タスクが実行されているデバイス、実行 ID、および実行のステータスが含まれます。
型: ExecutionSummary オブジェクトの配列
- nextToken
-
次ページの実行を続行するためのページ割りトークン。
型: 文字列
長さの制限: 最小長は 1 です。最大長は 1,024 です。
Pattern:
^[a-zA-Z0-9+/=]*$
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AccessDeniedException
-
このアクションを実行する十分なアクセス権限がありません。
HTTP ステータスコード: 403
- InternalServerException
-
リクエストの処理中に予期しないエラーが発生しました。
HTTP ステータスコード: 500
- ResourceNotFoundException
-
リクエストは、存在しないリソースを参照しています。
HTTP ステータスコード: 404
- ThrottlingException
-
リクエストのスロットリングにより、リクエストが拒否されました。
HTTP ステータスコード: 429
- ValidationException
-
入力が AWS サービスで指定された制約を満たさない。
HTTP ステータスコード: 400
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。