ListExecutions - AWS Snowball

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

ListExecutions

傳回一或多個目標裝置的任務狀態。

請求語法

GET /executions?maxResults=maxResults&nextToken=nextToken&state=state&taskId=taskId HTTP/1.1

URI 請求參數

請求使用以下URI參數。

maxResults

每頁要列出的任務數量上限。

有效範圍:最小值為 1。最大值為 100。

nextToken

分頁權杖,以繼續前往任務的下一頁。

長度限制:長度下限為 1。長度上限為 1024。

模式:^[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。長度上限為 1024。

模式:^[a-zA-Z0-9+/=]*$

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

AccessDeniedException

您沒有足夠的存取權來執行此動作。

HTTP 狀態碼:403

InternalServerException

處理請求時發生非預期的錯誤。

HTTP 狀態碼:500

ResourceNotFoundException

請求參考不存在的資源。

HTTP 狀態碼:404

ThrottlingException

由於請求調節,因此請求遭到拒絕。

HTTP 狀態碼:429

ValidationException

輸入無法滿足 AWS 服務指定的限制條件。

HTTP 狀態碼:400

另請參閱

如需在其中一種語言特定的 API中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: