AI 助理
文档备案控制台
官方文档
首页 弹性高性能计算 E-HPC Cluster（原E-HPC NEXT） 开发参考 API参考 API目录 集群 GetCluster - 查询集群详情

GetCluster - 查询集群详情

更新时间：
复制 MD 格式
产品详情
我的收藏

查询指定E-HPC集群信息。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ehpc:GetCluster

get

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
ClusterId

string

否

集群 ID。

ehpc-hz-FYUr32****

返回参数

名称

类型

描述

示例值

object

返回参数集合。

RequestId

string

请求 ID。

04F0F334-1335-436C-A1D7-6C044FE73368
ClusterId

string

E-HPC 集群 ID

ehpc-hz-FYUr32****
ClusterName

string

E-HPC 集群名称

slurm22.05.8-cluster-20240614
ClusterCategory

string

集群系列，可能值：

  • Standard

  • Serverless

Standard
MaxCount

string

集群可管理的计算节点数量。

100
MaxCoreCount

string

集群可管理的计算节点总核数。

10000
DeleteProtection

string

集群是否开启删除保护。可能值：

  • true：启动删除保护。

  • false：不启用删除保护。

true
ResourceGroupId

string

资源组 ID。

rg-acfmxazb4ph****
ClusterCreateTime

string

集群的创建时间。以 ISO 8601 为标准，并使用 UTC+0 时间，格式为 yyyy-MM-ddTHH:mmZ。更多信息，请参见ISO 8601。

2024-08-06T12:43:01.000Z

ClusterModifyTime

string

集群的修改时间。以 ISO 8601 为标准，并使用 UTC+0 时间，格式为 yyyy-MM-ddTHH:mmZ。更多信息，请参见ISO 8601。

2024-08-06T12:43:01.000Z

ClusterVpcId

string

集群使用的专有网络 VPC ID。

vpc-uf6u3lk1pjy28eg*****
ClusterVSwitchId

string

集群使用的虚拟交换机 ID。

vsw-bp1p2uugqsjppno******
SecurityGroupId

string

安全组 ID。

sg-f8z9vb2zaezpkr69a21k
EhpcVersion

string

E-HPC 产品版本号。

2.0.0
ClientVersion

string

集群使用的 E-HPC Util 版本。

2.0.31
ClusterStatus

string

集群状态。可能值：

  • uninit：安装中

  • creating：创建中

  • initing：初始化中

  • running；运行中

  • exception：异常

  • raleasing：释放中

  • stopping：停止中

  • stopped：已停止

  • pending：待配置

running
ClusterMode

string

集群的部署类型。可能值：

  • Integrated：公共云

  • Hybrid：混合云

  • Custom：自定义集群

Integrated
Manager

object

集群管理节点配置。

Scheduler

object

调度器服务信息。

Type

string

调度器类型。可能值：

  • SLURM

  • PBS

  • OPENGRIDSCHEDULER

  • LSF_PLUGIN

  • PBS_PLUGIN

SLURM
Version

string

调度器版本。

22.05.8
Status

string

调度器服务状态，可能值：

  • uninit：安装中

  • initing：初始化中

  • running：运行中

  • exception：异常

  • releasing：释放中

  • stopped：已停止

  • pending：待配置

running
DirectoryService

object

域账号服务信息。

Type

string

域账号类型。

nis
Version

string

域账号版本。

2.31
Status

string

域账号服务状态，可能值：

  • uninit：安装中

  • initing：初始化中

  • running：运行中

  • exception：异常

  • releasing：释放中

  • stopped：已停止

  • pending：待配置

running
DNS

object

域名解析服务配置信息。

Type

string

域名解析类型。

nis
Version

string

域名解析版本。

2.31
Status

string

域名解析服务状态，可能值：

  • uninit：安装中

  • initing：初始化中

  • running：运行中

  • exception：异常

  • releasing：释放中

  • stopped：已停止

  • pending：待配置

running
ManagerNode

object

管理节点的配置信息。

InstanceId

string

管理节点实例 ID。

i-bp1a170jgea1vl******
InstanceType

string

管控节点实例规格。

ecs.g6.4xlarge
InstanceChargeType

string

管理节点的实例付费类型。可能值：

  • PostPaid：按量付费

  • PrePaid：包年包月

PostPaid
ExpiredTime

string

管理节点的过期时间，采用 ISO 8601 格式的 UTC 时间，例如 YYYY-MM-DDTHH:mmZ。

2099-12-31T15:59Z
ImageId

string

集群管理节点使用的镜像 ID。

aliyun_2_1903_x64_20G_alibase_20200324.vhd
PeriodUnit

string

集群管理节点包年包月计费方式的时长单位。

Month
Period

integer

集群管理节点包年包月付费类型是否开启自动续费。

1
AutoRenew

boolean

集群管理节点包年包月付费类型是否开启自动续费。

true
AutoRenewPeriod

integer

集群管理节点包年包月付费类型单次自动续费的续费时长。

0
SpotStrategy

string

集群管理节点按量付费的竞价策略。

NoSpot
SpotPriceLimit

number

集群管理节点抢占式实例的每小时最高价格。

1
Duration

integer

集群管理节点抢占式实例的保有时长。

1
EnableHt

boolean

集群管理节点是否开启 HT。

true
SystemDisk

object

集群管理节点的系统盘配置。

Category

string

集群管理节点系统盘的云盘种类。

cloud_ssd
Size

integer

集群管理节点系统盘的大小，单位是 GiB。

40
Level

string

集群管理节点 ESSD 系统盘的性能等级。

PL0
ClusterCustomConfiguration

object

集群后处理脚本。

Script

string

后处理脚本的下载地址。

http://*****

Args

string

安装后脚本的执行参数。

E-HPC cn-hangzhou

GrowInterval

integer

集群自动扩容的时间间隔。

2
IdleInterval

integer

集群计算节点的空闲时间。

4
EnableScaleOut

boolean

集群是否开启自动扩容。可选值：

  • true：开启

  • false：关闭

true
EnableScaleIn

boolean

集群是否开启自动缩容，可能值：

  • true：开启

  • false：关闭

true
MonitorSpec

object

集群监控详情。

EnableComputeLoadMonitor

boolean

集群是否开启计算节点的监控组件，可能值：

  • true：开启

  • false：关闭

true
SchedulerSpec

object

集群调度详情。

EnableTopologyAwareness

boolean

集群是否开启拓扑感知功能，可能值：

  • true：开启

  • false：关闭

true
EnablePowerSaving

boolean

调度器是否开启节能模式。

true

示例

正常返回示例

JSON格式

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "ClusterId": "ehpc-hz-FYUr32****",
  "ClusterName": "slurm22.05.8-cluster-20240614",
  "ClusterCategory": "Standard",
  "MaxCount": "100",
  "MaxCoreCount": "10000",
  "DeleteProtection": "true",
  "ResourceGroupId": "rg-acfmxazb4ph****",
  "ClusterCreateTime": "2024-08-06T12:43:01.000Z\n",
  "ClusterModifyTime": "2024-08-06T12:43:01.000Z\n",
  "ClusterVpcId": "vpc-uf6u3lk1pjy28eg*****",
  "ClusterVSwitchId": "vsw-bp1p2uugqsjppno******",
  "SecurityGroupId": "sg-f8z9vb2zaezpkr69a21k",
  "EhpcVersion": "2.0.0",
  "ClientVersion": "2.0.31",
  "ClusterStatus": "running",
  "ClusterMode": "Integrated",
  "Manager": {
    "Scheduler": {
      "Type": "SLURM",
      "Version": "22.05.8",
      "Status": "running"
    },
    "DirectoryService": {
      "Type": "nis",
      "Version": "2.31",
      "Status": "running"
    },
    "DNS": {
      "Type": "nis",
      "Version": "2.31",
      "Status": "running"
    },
    "ManagerNode": {
      "InstanceId": "i-bp1a170jgea1vl******",
      "InstanceType": "ecs.g6.4xlarge",
      "InstanceChargeType": "PostPaid",
      "ExpiredTime": "2099-12-31T15:59Z",
      "ImageId": "aliyun_2_1903_x64_20G_alibase_20200324.vhd",
      "PeriodUnit": "Month",
      "Period": 1,
      "AutoRenew": true,
      "AutoRenewPeriod": 0,
      "SpotStrategy": "NoSpot",
      "SpotPriceLimit": 1,
      "Duration": 1,
      "EnableHt": true,
      "SystemDisk": {
        "Category": "cloud_ssd",
        "Size": 40,
        "Level": "PL0"
      }
    }
  },
  "ClusterCustomConfiguration": {
    "Script": "http://*****\n",
    "Args": "E-HPC cn-hangzhou\n"
  },
  "GrowInterval": 2,
  "IdleInterval": 4,
  "EnableScaleOut": true,
  "EnableScaleIn": true,
  "MonitorSpec": {
    "EnableComputeLoadMonitor": true
  },
  "SchedulerSpec": {
    "EnableTopologyAwareness": true,
    "EnablePowerSaving": true
  }
}

错误码

HTTP status code

错误码

错误信息

描述
404 ClusterNotFound The specified cluster does not exist. 指定的集群不存在，请您检查该参数是否正确。
503 ServiceUnavailable The request has failed due to a temporary failure of the server 请求失败，服务暂时不可用

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

变更历史

更多信息，参考变更详情。

上一篇：ListAddonTemplates - 查询组件模板列表下一篇：GetAddon - 查询已安装组件详情