GetCluster - 查询集群详情_弹性高性能计算(E-HPC)-阿里云帮助中心

查询指定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	管理节点的过期时间。	2099-12-31T15:59Z
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

示例

正常返回示例

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"
    }
  },
  "ClusterCustomConfiguration": {
    "Script": "http://*****\n",
    "Args": "E-HPC cn-hangzhou\n"
  },
  "GrowInterval": 2,
  "IdleInterval": 4,
  "EnableScaleOut": true,
  "EnableScaleIn": 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	请求失败，服务暂时不可用

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