ListClusterJobs - AWS Snowball

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

ListClusterJobs

返回指定長度的JobListEntry對象的數組。每個JobListEntry物件都適用於指定叢集中的工作,並包含作業的狀態、作業 ID 和其他資訊。

請求語法

{ "ClusterId": "string", "MaxResults": number, "NextToken": "string" }

請求參數

如需所有動作的一般參數資訊,請參閱《Common Parameters》。

請求接受採用 JSON 格式的下列資料。

ClusterId

例如,您要列出之叢集的 39 個字元識別碼。CID123e4567-e89b-12d3-a456-426655440000

類型:字串

長度限制:固定長度為 39。

模式:CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

必要:是

MaxResults

要傳回的JobListEntry物件數目。

類型:整數

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

必要:否

NextToken

HTTP 請求是無狀態的。要確定對象列表中的「下一個」對JobListEntry象,您可以選擇指定NextToken為返回列表的起點。

類型:字串

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

模式:.*

必要:否

回應語法

{ "JobListEntries": [ { "CreationDate": number, "Description": "string", "IsMaster": boolean, "JobId": "string", "JobState": "string", "JobType": "string", "SnowballType": "string" } ], "NextToken": "string" }

回應元素

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

服務會傳回下列 JSON 格式的資料。

JobListEntries

在匯出工作的情況下,每個JobListEntry物件都包含工作的狀態、工作 ID 以及指示工作是否為工作一部分的值。

類型:JobListEntry 物件陣列

NextToken

HTTP 請求是無狀態的。如果您在下次ListClusterJobsResult呼叫中使用自動產生的NextToken值,則傳回的工作清單將從陣列中的此點開始。

類型:字串

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

模式:.*

錯誤

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

InvalidNextTokenException

NextToken串意外變更,且作業已停止。在不變更NextToken字串的情況下執行作業,然後再試一次。

HTTP 狀態碼:400

InvalidResourceException

找不到指定的資源。請檢查您上次要求中提供的資訊,然後再試一次。

HTTP 狀態碼:400

另請參閱

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