本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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 的詳細資訊,請參閱下列內容: