查询用户账号中在每个地域拥有的所有集群的列表。

查询集群列表前,您可以调用ListRegions查询可用地域列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListClusters

集群简要信息数组,ClusterInfoSimple 结构见下面的对象描述。

PageNumber Integer 1

显示的页码,起始值为 1。

PageSize Integer 10

每页显示的条数,取值1-50。

返回数据

名称 类型 示例值 描述
Clusters Array

集群详细信息。

ClusterInfoSimple
AccountType String nis

账户服务器类型,现在仅支持 nis。

BaseOsTag String CentOS_7.2_64

基础镜像操作系统标签(管控节点用)。

Computes Struct

计算节点信息。

ExceptionCount Integer 0

异常节点数。

NormalCount Integer 1

正常节点数。

OperatingCount Integer 1

操作进行中的节点数(初始化,安装中,释放中等状态)。

StoppedCount Integer 0

停止节点数。

Total Integer 2

总节点数。

Count Integer 3

集群计算节点数目。

CreateTime String 2020年2月21日 14:38:13

集群创建时间。

DeployMode String Standard

部署模式:

Standard: 账号节点

  • 调度节点
  • 登录节点
  • 计算节点

    Advanced: HA模式

    Simple: (账号

  • 调度)节点
  • 登录节点
  • 计算节点

    Tiny:(账号

  • 调度
  • 登录)节点
  • 计算节点

    OneBox:(账号

  • 调度
  • 登录
  • 计算)节点
  • 更多计算节点
Description String xx

集群描述。

EhpcVersion String 1.0.0

EHPC版本。

Id String ehpc-hz-jeJki6Zam8

集群ID。

ImageId String wi_1607_x64_dtc_zh_40G_alibase_xxxxxx13.vh

镜像ID。

ImageOwnerAlias String system

镜像类型,取值:system、self、others 或 marketplace

InstanceType String ecs.n1.tiny

计算节点实例规格。

Location String PublicCloud

集群所在位置。OnPremise:本地集群(混合云),PublicCloud:公共云。

LoginNodes String xxxxxxx

登录节点列表, {Id:}

Managers Struct

管理节点信息。

ExceptionCount Integer 0

异常节点数。

NormalCount Integer 1

正常节点数。

OperatingCount Integer 1

操作进行中的节点数(初始化,安装中,释放中等状态)。

StoppedCount Integer 0

停止节点数。

Total Integer 2

总管理节点数目。

Name String test

集群名称。

NodePrefix String test

主机前缀名。

NodeSuffix String name

主机后缀名。

OsTag String CentOS_7.2_64

操作系统镜像标签。

RegionId String cn-hangzhou

地域ID。

SchedulerType String pbs

调度服务器类型。如:pbs,ldap,custom等。

Status String running

集群状态。

TotalResources Struct

集群资源总量。

Cpu Integer 1

CPU资源。

Gpu Integer 0

GPU资源。

Memory Integer 1024

内存资源。

UsedResources Struct

集群资源使用量。

Cpu Integer 1

CPU资源,单位:核。

Gpu Integer 0

GPU资源,单位:卡。

Memory Integer 1024

内存资源。

VSwitchId String vsw-bp10eeeeeeeeeeeeza8a

交换机ID。

VpcId String vpc-b3f3edefefeep0760yjuje9h

VPC ID。

ZoneId String cn-hangzhou-

可用区ID。

PageNumber Integer 1

当前页码。

PageSize Integer 10

本页条数。

RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

请求ID。

TotalCount Integer 3

列表条目总数。

示例

请求示例

http(s)://[Endpoint]/?Action=ListClusters
&<公共请求参数>

正常返回示例

XML 格式

<ListClustersResponse>
      <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
      <TotalCount>1</TotalCount>
      <PageNumber>1</PageNumber>
      <PageSize>1</PageSize>
      <Clusters>
            <ClusterInfoSimple>
                  <Id>ehpc-hz-4VMqwGqwbj</Id>
                  <RegionId>cn-hangzhou</RegionId>
                  <ZoneId>cn-hangzhou-e</ZoneId>
                  <Name>Example-cluster-name</Name>
                  <Description>Example cluster description</Description>
                  <Status>running</Status>
                  <AccountType>nis</AccountType>
                  <SchedulerType>pbs</SchedulerType>
                  <DeployMode>Standard</DeployMode>
                  <Count>1</Count>
                  <InstanceType>ecs.n1.tiny</InstanceType>
                  <LoginNodes>[{"Id":"i-bp19oxc76s5iggdgudgw"}]</LoginNodes>
                  <CreateTime>2018-05-30T03:08:06.000Z</CreateTime>
                  <ImageOwnerAlias>system</ImageOwnerAlias>
                  <ImageId>centos_7_02_64_20G_alibase_20170818.vhd</ImageId>
                  <Location>public_cloud</Location>
                  <Managers>
                        <Total>2</Total>
                        <NormalCount>2</NormalCount>
                        <OperationCount>0</OperationCount>
                        <StoppedCount>0</StoppedCount>
                        <ExceptionCount>0</ExceptionCount>
                  </Managers>
                  <Computes>
                        <Total>1</Total>
                        <NormalCount>1</NormalCount>
                        <OperationCount>0</OperationCount>
                        <StoppedCount>0</StoppedCount>
                        <ExceptionCount>0</ExceptionCount>
                  </Computes>
                  <TotalResources>
                        <Cpu>1</Cpu>
                        <Memory>1024</Memory>
                        <Gpu>0</Gpu>
                  </TotalResources>
                  <UsedResources>
                        <Cpu>0</Cpu>
                        <Memory>0</Memory>
                        <Gpu>0</Gpu>
                  </UsedResources>
            </ClusterInfoSimple>
      </Clusters>
</ListClustersResponse>

JSON 格式

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "TotalCount": "1",
    "PageNumber": "1",
    "PageSize": "1",
    "Clusters": {
      "ClusterInfoSimple": {
        "Id": "ehpc-hz-4VMqwGqwbj",
        "RegionId": "cn-hangzhou",
        "ZoneId": "cn-hangzhou-e",
        "Name": "Example-cluster-name",
        "Description": "Example cluster description",
        "Status": "running",
        "AccountType": "nis",
        "SchedulerType": "pbs",
        "DeployMode": "Standard",
        "Count": "1",
        "InstanceType": "ecs.n1.tiny",
        "LoginNodes": "[{\"Id\":\"i-bp19oxc76s5iggdgudgw\"}]",
        "CreateTime": "2018-05-30T03:08:06.000Z",
        "ImageOwnerAlias": "system",
        "ImageId": "centos_7_02_64_20G_alibase_20170818.vhd",
        "Location": "public_cloud",
        "Managers": {
          "Total": "2",
          "NormalCount": "2",
          "OperationCount": "0",
          "StoppedCount": "0",
          "ExceptionCount": "0"
        },
        "Computes": {
          "Total": "1",
          "NormalCount": "1",
          "OperationCount": "0",
          "StoppedCount": "0",
          "ExceptionCount": "0"
        },
        "TotalResources": {
          "Cpu": "1",
          "Memory": "1024",
          "Gpu": "0"
        },
        "UsedResources": {
          "Cpu": "0",
          "Memory": "0",
          "Gpu": "0"
        }
      }
    }
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParams Invalid param: %s 无效的参数: {}

访问错误中心查看更多错误码。