ListClusters - AWS Snowball

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

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,請參閱下列內容: