全部产品
Search
文档中心

:获取集群列表

更新时间:Apr 12, 2018

方法说明

列举当前用户的集群,支持分页(listClusters)。

参数说明

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

返回值说明

  • 成功后返回一个 ListClustersResponse 实例, 可以通过这个实例的 getItems 方法,拿到 List<Cluster> 对象。

  • 如果失败,抛出异常: ClientException。

代码示例

  1. try{
  2. ListClustersResponse response = client.listClusters();
  3. //成功
  4. List<Cluster> list = response.getItems();
  5. }catch(ClientException e){
  6. e.printStackTrace();
  7. //失败
  8. }

(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