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" }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 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

另請參閱

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