本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
ListClusters
返回指定长度的 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在一种特定语言中使用此功能的更多信息 AWS SDKs,请参阅以下内容: