AI 助理
文档备案控制台
官方文档
首页

CreateCluster - 创建集群

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

创建一个按量付费或者预付费（包年包月）集群。

接口说明

接口说明

请确保在使用该接口前，已充分了解 E-HPC 产品的收费方式和价格。更多信息，请参见计费概述。

调试

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

调试

授权信息

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

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

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

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

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

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

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

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

操作

访问级别

资源类型

条件关键字

关联操作

ehpc:CreateCluster

create

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
ClusterName

string

否

集群名称。长度为 2~128 个字符，支持英文、中文和数字。可以包含短划线（-）和下划线（_）。

slurm22.05.8-cluster-20240718
ClusterDescription

string

否

集群描述。长度为 2~128 个字符，支持英文、中文和数字。可以包含短划线（-）和下划线（_）。

slurm22.05.8-cluster-20240718

ClusterCategory

string

否

集群系列，取值范围：

  • Standard：标准版。

  • Serverless：托管版。

枚举值：

  • Standard :

    Standard

  • Serverless :

    Serverless

Standard
ClusterVpcId

string

否

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

vpc-m5efjevmclc0xdmys****
ClusterVSwitchId

string

否

集群使用的虚拟交换机 ID。虚拟交换机 ID 需在ClusterVpcId中。

您可以调用 DescribeVpcs 查询已创建的 VPC 和 VSwitch 信息。

vsw-f8za5p0mwzgdu3wgx****
IsEnterpriseSecurityGroup

boolean

否

是否使用企业级安全组。取值范围：

  • true：自动创建并使用企业级安全组。

  • false：不使用企业级安全组，自动创建并使用普通安全组。

关于如何选择安全组类型，请参见普通安全组与企业级安全组。

枚举值：

  • true :

    true

  • false :

    false

false
SecurityGroupId

string

否

指定新创建集群所属的安全组 ID。

您可以调用 DescribeSecurityGroups 查询当前地域可以使用的安全组。

sg-bp13n61xsydodfyg****
ClientVersion

string

否

集群客户端版本。默认使用最新版本。

2.1.0
ClusterCustomConfiguration

object

否

集群后处理脚本。

Script

string

否

后处理脚本的下载地址。

http://*****
Args

string

否

安装后脚本的执行参数。

E-HPC cn-hangzhou
ClusterCredentials

object

否

集群的安全凭证。

KeyPairName

string

否

密钥对名称。长度为 2~128 个英文或中文字符。必须以大小写字母或中文开头，不能以http://和https://开头。可以包含数字、半角冒号（:）、下划线（_）或者短划线（-）。

说明

如果您要使用 ECS 密钥对功能，具体操作，请参见创建密钥对。

ali0824
Password

string

否

登录节点的 root 密码。长度为 8 至 20 个字符，必须同时包含大小写英文字母、数字和特殊符号中的三类字符。特殊符号可以是： () ~ ! @ # $ % ^ & * - = + { } [ ] : ; ‘ < > , . ? /

说明

建议使用 HTTPS 协议调用 API 避免密码泄露。

**********
MaxCount

integer

否

集群可管理的计算节点数量，取值范围：0～5,000。

500
MaxCoreCount

integer

否

集群可管理的计算节点总核数，取值范围：0～100,000。

10000
DeletionProtection

boolean

否

集群删除保护属性，指定是否支持通过控制台或 API DeleteCluster 删除集群。

  • true：开启集群删除保护。

  • false：关闭集群删除保护。

默认值：false。

枚举值：

  • true :

    true

  • false :

    false

false
ResourceGroupId

string

否

资源组 ID。

您可以调用 ListResourceGroups 查询资源组 ID。

rg-acfmxazb4******
Tags

array<object>

否

集群的标签列表。

object

否

集群的标签信息。

Key

string

否

集群的标签键。N 的取值范围：1~20。一旦传入该值，则不允许为空字符串。最多支持 128 个字符，不能以aliyun和acs:开头，不能包含http://或者https://。

ClusterId
Value

string

否

集群的标签值。N 的取值范围：1~20。一旦传入该值，可以为空字符串。最多支持 128 个字符，不能包含http://或者https://。

ehpc-hz-******
Manager

object

否

集群管理节点配置。

Scheduler

object

否

调度器服务配置信息。

Type

string

否

调度器类型。取值范围：

  • SLURM

  • PBS

  • OPENGRIDSCHEDULER

  • LSF_PLUGIN

  • PBS_PLUGIN

枚举值：

  • PBS :

    PBS

  • SLURM :

    SLURM

  • PBS_PLUGIN :

    PBS_PLUGIN

  • OPENGRIDSCHEDULER :

    OPENGRIDSCHEDULER

  • LSF_PLUGIN :

    LSF_PLUGIN

SLURM
Version

string

否

调度器版本。

22.05.8
DirectoryService

object

否

域账号服务配置信息。

Type

string

否

域账号类型。

枚举值：

  • NIS :

    NIS

NIS
Version

string

否

域账号版本。

2.31
DNS

object

否

域名解析服务配置信息。

Type

string

否

域名解析类型。

枚举值：

  • NIS :

    NIS

NIS
Version

string

否

域名解析版本。

2.31
ManagerNode NodeTemplate

否

管理节点的硬件配置信息。

Queues

array

否

集群队列的配置。队列数量支持 0～8 个。

QueueTemplate

否

集群队列的详细配置。

SharedStorages

array

否

集群共享存储配置。

SharedStorageTemplate

否

集群共享存储的详细配置。

AdditionalPackages

array<object>

否

集群待安装的软件列表，N 的取值范围：0～10。

object

否

待安装软件的具体信息。

Name

string

否

待安装软件名称。

mpich
Version

string

否

待安装软件版本。

4.0.3
Addons

array<object>

否

集群自定义服务组件配置，仅支持一个组件。

object

否

自定义服务组件的具体配置信息。

Name

string

是

自定义服务组件的名称。

Login
Version

string

是

自定义服务组件的版本。

1.0
ServicesSpec

string

否

自定义服务组件的服务配置。

"[{\\"ServiceName\\": \\"SSH\\", \\"ServiceAccessType\\": null, \\"ServiceAccessUrl\\": null, \\"NetworkACL\\": [{\\"IpProtocol\\": \\"TCP\\", \\"Port\\": 22, \\"SourceCidrIp\\": \\"0.0.0.0/0\\"}]}, {\\"ServiceName\\": \\"VNC\\", \\"ServiceAccessType\\": null, \\"ServiceAccessUrl\\": null, \\"NetworkACL\\": [{\\"IpProtocol\\": \\"TCP\\", \\"Port\\": 12016, \\"SourceCidrIp\\": \\"0.0.0.0/0\\"}]}, {\\"ServiceName\\": \\"CLIENT\\", \\"ServiceAccessType\\": \\"URL\\", \\"ServiceAccessUrl\\": \\"\\", \\"NetworkACL\\": [{\\"IpProtocol\\": \\"TCP\\", \\"Port\\": 12011, \\"SourceCidrIp\\": \\"0.0.0.0/0\\"}]}]"
ResourcesSpec

string

否

自定义服务组件的资源配置。

"{\\"EipResource\\": {\\"AutoCreate\\": true}, \\"EcsResources\\": [{\\"InstanceType\\": \\"ecs.c7.xlarge\\", \\"ImageId\\": \\"centos_7_6_x64_20G_alibase_20211130.vhd\\", \\"SystemDisk\\": {\\"Category\\": \\"cloud_essd\\", \\"Size\\": 40, \\"Level\\": \\"PL0\\"}, \\"EnableHT\\": true, \\"InstanceChargeType\\": \\"PostPaid\\", \\"SpotStrategy\\": \\"NoSpot\\"}]}"
ClusterMode

string

否

集群部署类型，取值范围：

  • Integrated：公共云集群。

  • Hybrid：混合云集群。

  • Custom：自定义集群。

枚举值：

  • Hybrid :

    Hybrid

  • Custom :

    Custom

  • Integrated :

    Integrated

Integrated
GrowInterval

integer

否

IdleInterval

integer

否

返回参数

名称

类型

描述

示例值

object

Schema of Response

Success

boolean

请求结果，可能值：

  • true：请求成功。

  • false：请求失败。

true
RequestId

string

请求 ID。

F6757FA4-8FED-4602-B7F5-3550C0******
ClusterId

string

集群 ID。

ehpc-hz-FYUr******
TaskId

string

任务 ID。

F6757FA4-8FED-4602-B7F5-3550C0******

示例

正常返回示例

JSON格式

{
  "Success": true,
  "RequestId": "F6757FA4-8FED-4602-B7F5-3550C0******",
  "ClusterId": "ehpc-hz-FYUr******",
  "TaskId": "F6757FA4-8FED-4602-B7F5-3550C0******\n"
}

错误码

HTTP status code

错误码

错误信息

描述
400 InvalidParams The specified parameter %s is invalid. 指定的参数 %s 无效。
400 OrderError.Arrearage Your account balance is less than CNY 100. Please add funds to your account and try again. 账户余额不足100元，请您先充值后再重试。
400 OrderError.InstHasUnpaidOrder Your account has an unpaid order. 账户存在未支付订单，请您先支付后再重试。
400 OrderError.InsufficientBalance The account balance is insufficient. Please add funds first and try again. 账户已欠费，请您先充值后再重试。
400 OrderError.InvalidPayMethod No valid default payment method is specified for your account. 没有有效的默认支付方式，请您查看支付方式是否正确。
400 OrderError.NoCard No credit card is bound to your account. 未绑定卡，请您先绑定后再重试。
400 OrderError.NoRealNameAuthentication You have not completed the real name authentication. 未完成实名验证，请您先进行实名认证后重试。
400 OrderError.NoRealNameRegistration Real name registration is required for instances launched in mainland China. 国际站用户购买中国内地地域云产品，未完成实名注册。
400 OrderError.UserProfileIncomplete You have not completed your user profile. 国际站用户未完善个人信息。
400 Cluster.NotSupported Current cluster does not support this operation. 当前集群不支持该操作。
403 ConflictOpt A conflicting operation is running. 有冲突的操作在执行中，请您稍后再试。
403 TooManyClusters The number of user clusters exceeds the quota. 用户集群数量超过配额限制，如需更多，请参考产品使用限制文档的方式提升配额。
404 KeyPairNotFound The specified KeyPair does not exist. 指定的密钥对不存在，请您检查该参数是否正确。
404 ImageNotFound The specified image does not exist. 指定的镜像不存在，请您检查该参数是否正确。
503 ServiceUnavailable The request has failed due to a temporary failure of the server 请求失败，服务暂时不可用
406 DbError A database service error occurred. 数据库请求失败
406 OrderError An order request error occurred. 订单请求失败

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

变更历史

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

上一篇：集群下一篇：UpdateCluster - 修改集群信息