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

回應元素

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

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

ClusterListEntries

每個ClusterListEntry物件都包含叢集的狀態、叢集的 ID 以及其他重要狀態資訊。

類型：ClusterListEntry 物件陣列

NextToken

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

類型：字串

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

模式：.*

錯誤

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

InvalidNextTokenException

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

HTTP 狀態碼：400

另請參閲

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：