本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
ListClusters
重要
终止支持通知： Amazon 将于 2024 年 11 月 12 日停用上一代 Snowbal Amazon l 设备以及两款 Snowcone 设备（HDD 和 SDD）。我们将在 2025 年 11 月 12 日之前继续为使用这些 end-of-life设备的现有客户提供支持。所有客户均可使用最新一代的 Amazon Snowball 设备。有关更多信息，请访问此博客文章
返回指定长度的 ClusterListEntry 对象的数组。每个 ClusterListEntry 对象都包含集群的状态、集群的 ID 和其他重要状态信息。
请求语法
{
"MaxResults": number,
"NextToken": "string"
}请求参数
有关所有操作的通用参数的信息，请参阅常用参数。
请求接受采用 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
另请参阅
有关以特定语言之一使用此 API 的更多信息 Amazon SDKs，请参阅以下内容：