ListClusters - AWS Snowball

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

ListClusters

返回指定长度的ClusterListEntry对象的数组。每个ClusterListEntry对象都包含集群的状态、群集的 ID 和其他重要的状态信息。

请求语法

{ "MaxResults": number, "NextToken": "string" }

请求参数

有关由所有操作没有任何Comon (常用参数) Comon 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 的更多信息,请参阅以下内容: