方法说明
列举当前用户的集群,支持分页(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