获取集群列表 -

方法说明

列举当前用户的集群，支持分页（listClusters）。

参数说明

参数	类型	是否必选	说明
marker	String	否	本页起始资源标识符。默认为空字符串。
maxItemCount	int	否	返回条数，最大取值200，默认200

返回值说明

成功后返回一个 ListClustersResponse 实例，可以通过这个实例的 getItems 方法，拿到 List<Cluster> 对象。
如果失败，抛出异常： ClientException。

代码示例

try{
  ListClustersResponse response = client.listClusters();
  //成功
  List<Cluster> list = response.getItems();
}catch(ClientException e){
  e.printStackTrace();
  //失败
}

(1) Cluster 属性：

属性	类型	说明
id	String	集群ID
name	String	集群名称
ownerId	long	所有者ID。
description	String	简短描述
state	String	集群状态。仅支持”Active”和”Deleting”。
creationTime	Date	创建时间
instanceType	String	构建集群的实例类型。每个Region支持的实例类型是不一样的。
imageId	String	支持ECS镜像ID和注册的镜像ID。
operationLogs	List<String>	操作日志
metrics	ClusterMatrics	各种状态的实例个数
groups	Map<String, Group>	实例组
userData	Map<String, String>	用户数据
configs	Configs	集群的一些配置信息，比如实例的磁盘配置，由Configs描述。

(2) ClusterMatrics 属性：

属性	类型	说明
startingCount	long	正在启动的实例个数
runningCount	long	正在运行的实例个数
stoppingCount	long	正在停止的实例个数
stoppedCount	long	已经停止的实例个数

(3) Group 属性：

属性	类型	说明
desiredVMCount	int	期望启动实例个数
actualVMCount	int	实际启动实例个数
instanceType	String	ECS实例类型。
resourceType	String	资源类型，目前只支持：”OnDemand”。

(4) Configs

属性名称	类型	是否必须	描述
Disks	object	否	集群中包含的实例的磁盘配置信息，由Disks描述。

(5) Disks

属性名称	类型	是否必须	描述
SystemDisk	object	否	系统盘信息，由SystemDisk描述。
DataDisk	array	否	数据盘信息，DataDisk列表。

(6) SystemDisk

属性名称	类型	是否必须	描述
Type	string	否	磁盘类型，默认为“ephemeral”。
Size	int	是	磁盘大小。范围依据磁盘类型不同。

系统盘的磁盘种类可选值：

ephemeral - 本地磁盘

系统盘大小，以GB为单位，取值范围为：

ephemeral - 40~500

默认值：size=max{40，镜像大小}

指定该参数后，size必须大于等于max{40, 镜像大小}。

(7) DataDisk

属性名称	类型	是否必须	描述
Type	string	否	磁盘类型，默认为“ephemeral”。
Size	int	是	磁盘大小。范围依据磁盘类型不同。
MountPoint	string	否	磁盘挂载点。

数据盘的磁盘种类可选值：

ephemeral - 本地磁盘

数据盘的磁盘大小。以 GB 为单位，取值范围为：

ephemeral - 5~1024