本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
ListClusters
傳回指定長度的ClusterListEntry
物件陣列。每個ClusterListEntry
物件都包含叢集的狀態、叢集的 ID 和其他重要的狀態資訊。
請求語法
{
"MaxResults": number
,
"NextToken": "string
"
}
請求參數
如需所有動作的一般參數資訊,請參閱《Common Parameters》。
請求接受下列JSON格式的資料。
- MaxResults
-
要傳回的
ClusterListEntry
物件數目。類型:整數
有效範圍:最小值為 0。最大值為 100。
必要:否
- NextToken
-
HTTP 請求是無狀態的。若要識別物件清單中的「下一個」
ClusterListEntry
物件,您可以選擇指定NextToken
作為傳回清單的起點。類型:字串
長度限制:長度下限為 1。長度上限為 1024。
模式:
.*
必要:否
回應語法
{
"ClusterListEntries": [
{
"ClusterId": "string",
"ClusterState": "string",
"CreationDate": number,
"Description": "string"
}
],
"NextToken": "string"
}
回應元素
如果動作成功,服務會傳回 200 HTTP 個回應。
服務會以 JSON 格式傳回下列資料。
- ClusterListEntries
-
每個
ClusterListEntry
物件都包含叢集的狀態、叢集的 ID 和其他重要的狀態資訊。類型:ClusterListEntry 物件陣列
- NextToken
-
HTTP 請求是無狀態的。如果您在下一次
ClusterListEntry
通話中使用自動產生的NextToken
值,則傳回的叢集清單將從陣列的這個時間點開始。類型:字串
長度限制:長度下限為 1。長度上限為 1024。
模式:
.*
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- InvalidNextTokenException
-
NextToken
字串發生意外變更,操作已停止。在不變更NextToken
字串的情況下執行操作,然後再試一次。HTTP 狀態碼:400
另請參閱
如需在其中一種語言特定 API中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: