调用CreateCluster创建一个按量付费或者包年包月的集群。

接口说明

在创建集群前,您可以:

创建集群会涉及资源计费,建议您提前了解E-HPC的计费方式。更多信息,请参见计费方式

调试

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

请求参数

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

系统规定参数。取值:CreateCluster

EcsOrder.Compute.Count Integer 1

集群计算节点数量。取值范围:1~99

EcsOrder.Compute.InstanceType String ecs.n1.tiny

集群计算节点实例规格。

EcsOrder.Login.Count Integer 1

集群登录节点数量。取值范围:1~99

EcsOrder.Login.InstanceType String ecs.n1.tiny

集群登录节点实例规格。

EcsOrder.Manager.InstanceType String ecs.n1.tiny

集群管控节点实例规格。

Name String test

集群名称。

OsTag String CentOS_7.2_64

操作系统镜像标签。

ZoneId String cn-hangzhou-b

可用区ID。

Description String TestDescription

集群描述信息。长度为2~256个英文或中文字符,不能以http://和https://开头。

默认值:空

EhpcVersion String 1.0.0

E-HPC产品版本。

ClientVersion String 1.0.64

集群客户端版本。

AccountType String nis

域账号服务类型。取值范围:

  • nis
  • ldap
SchedulerType String pbs

调度器类型。取值范围:

  • pbs
  • slurm
  • opengridscheduler
  • deadline
SecurityGroupId String sg-bp13n61xsydodfyg****

使用已有安全组ID创建集群。

SecurityGroupName String ehpc-SecurityGroup

如果不使用已有安全组,则使用此名称创建新安全组,应用默认策略。

VpcId String vpc-b3f3edefefeep0760yju****

集群所属的VPC ID。

VSwitchId String vsw-bp1lfcjbfb099rrjn****

VPC中交换机ID。产品目前仅支持VPC网络。

VolumeType String NAS

共享存储类型,目前仅支持NAS。

VolumeId String 008b64****

阿里云NAS实例ID。目前不支持自动创建阿里云NAS实例。

VolumeProtocol String NFS

共享存储的协议类型。取值范围:

  • NFS
  • SMB
VolumeMountpoint String 008b648bcb-s****.cn-hangzhou.nas.aliyuncs.com

NAS的VPC挂载点。目前不支持自动创建阿里云NAS挂载点。

RemoteDirectory String NasMountpoint:/RemoteDirectory

挂载共享存储的远程目录。

DeployMode String Simple

集群部署模式。取值范围:

  • Standard:账号节点、调度节点、登录节点、计算节点分离部署。
  • Advanced:HA模式部署。
  • Simple:账号节点和调度节点混合部署在一个节点上,登录节点和计算节点分离部署。
  • Tiny:账号节点、调度节点、登录节点混合部署在一个节点上,计算节点分离部署。
  • OneBox:账号节点、调度节点、登录节点、计算节点混合部署在一个节点上。
HaEnable Boolean true

是否开启高可用。取值范围:

  • true:开启
  • false:不开启
    说明 若开启高可用则集群中的每种管控角色将会使用主备2台实例。
EcsChargeType String PostPaid

集群使用ECS实例的付费类型.取值范围:

  • PostPaid:按量付费
  • PrePaid:包年包月

若选择包年包月类型,默认开启自动续费,节点释放后将关闭自动续费。

Password String 123****

登录节点的root密码。长度为8至30个字符,必须同时包含大小写英文字母、数字和特殊符号中的三类字符。特殊符号可以是:

( ) ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ‘ < > , . ? /
说明 建议使用HTTPS协议调用API避免密码泄露。
KeyPairName String test

密钥对名称。

说明 如果您要使用ECS密钥对功能,具体操作请参见创建密钥对
ImageOwnerAlias String self

镜像类型。取值范围:

  • system:公共镜像
  • self:自定义镜像
  • others:共享镜像
  • marketplace:镜像市场镜像
ImageId String centos_7_02_64_20G_alibase_20170818****

镜像ID。

EcsOrder.Manager.Count Integer 1

集群管控节点数量。取值范围:1~99

SccClusterId String 00b648b****

使用SCC机型创建集群。

说明 如果传入此字段,则使用指定的SccCluster创建集群,否则将替用户创建SCC实例。
ComputeSpotStrategy String NoSpot

计算节点竞价策略。取值范围:

  • NoSpot:正常按量付费实例。
  • SpotWithPriceLimit:设置上限价格的抢占式实例。
  • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格。
ComputeSpotPriceLimit String 0.034

计算节点实例的每小时最高价格。支持最大3位小数,参数ComputeSpotStrategy取值为SpotWithPriceLimit时生效。

ComputeEnableHt Boolean true

计算节点是否支持超线程。

Application.N.Tag String OpenMPI_11.1

第N个应用软件的标签。

AdditionalVolumes.N.VolumeType String nas

第N个附加挂载的数据卷类型。目前仅支持NAS。

N的取值范围:1~10

AdditionalVolumes.N.VolumeId String extreme-00b88****

第N个附加挂载的存储卷实例ID。

AdditionalVolumes.N.VolumeProtocol String NFS

第N个附加挂载的存储卷存储协议。取值范围:

  • NFS
  • SMB
AdditionalVolumes.N.VolumeMountpoint String 0088****-sihc.cn-hangzhou.extreme.nas.aliyuncs.com

第N个附加挂载的存储卷挂载点地址。

AdditionalVolumes.N.RemoteDirectory String /test

第N个附加挂载的存储卷需要挂载的远程目录。

AdditionalVolumes.N.LocalDirectory String /ff

第N个附加挂载存储卷本地挂载目录。

AdditionalVolumes.N.Roles.N.Name String ["Compute"]

第N个附加挂载的存储卷挂载到新NAS上的节点类型。

AdditionalVolumes.N.Location String PublicCloud

第N个附加挂载的存储卷资源存储位置。可能值:

  • OnPremise:混合云集群。
  • PublicCloud:公有云集群。
AdditionalVolumes.N.JobQueue String high

第N个附加挂载的存储卷节点作业所处队列。

PostInstallScript.N.Url String /opt/job.sh

第N个安装后脚本的下载地址。

PostInstallScript.N.Args String bashfile.sh

第N个安装后脚本的执行参数。

Period Integer 1

购买ECS实例的计费时长。取值范围:

  • 当参数PriceUnit取值为Month时:1~9
  • 当参数PriceUnit取值为Year时:1~3
  • 当参数PriceUnit取值为Hour时:1

默认值:1

PeriodUnit String Week

购买资源的时长。取值范围:

  • Week
  • Month
  • Hour
AutoRenew String false

是否自动续费。取值范围:

  • true:自动续费
  • false:不自动续费

默认值:false

AutoRenewPeriod Integer 1

每次自动续费的时长,当参数AutoRenew取值True时生效。

InputFileUrl String https://ehpc-tianshui.oss-cn-beijing.aliyuncs.com/test-u****/testlist_ehpc.sh

上传到OSS的作业文件的URL地址。

JobQueue String workq

计算节点加入的队列名称。

SystemDiskType String cloud_ssd

系统盘的云盘种类。取值范围:

  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD云盘
  • cloud_essd:ESSD云盘
  • cloud:普通云盘

其中cloud类型已停售。

SystemDiskSize Integer 40

系统盘大小,单位:GiB

取值范围:40~2000

RemoteVisEnable String false

是否开启远程可视化。取值范围:

  • true:开启
  • false:不开启

默认值:false

ResourceGroupId String rg-acfmxazb4ph****

资源组ID。

ClientToken String 123e4567-e89b-12d3-a456-426655440000

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性

WithoutElasticIp Boolean true

登录节点是否使用弹性公网IP。默认值:false

SystemDiskLevel String PL0

创建ESSD云盘作为系统盘使用时,设置云盘的性能等级。取值范围:

  • PL0:单盘最高随机读写IOPS 1万
  • PL1:单盘最高随机读写IOPS 5万
  • PL2:单盘最高随机读写IOPS 10万
  • PL3:单盘最高随机读写IOPS 100万

默认值:PL0

关于如何选择ESSD性能等级,请参见ESSD云盘

返回数据

名称 类型 示例值 描述
ClusterId String ehpc-hz-FYUr32****

集群ID。

RequestId String F6757FA4-8FED-4602-B7F5-3550C0842122

请求ID。

TaskId String F6757FA4-8FED-4602-B7F5-3550C0842122

任务ID。

示例

请求示例

https://ehpc.cn-hangzhou.aliyuncs.com/?Action=CreateCluster
&EcsOrder.Compute.Count=1
&<公共请求参数>

正常返回示例

XML格式

<CreateClusterResponse>
      <ClusterId>ehpc-hz-FYUr32****</ClusterId>
      <RequestId>F6757FA4-8FED-4602-B7F5-3550C0842122</RequestId>
      <TaskId>F6757FA4-8FED-4602-B7F5-3550C0842122</TaskId>
</CreateClusterResponse>

JSON格式

{
    "ClusterId":"ehpc-hz-FYUr32****",
    "RequestId":"F6757FA4-8FED-4602-B7F5-3550C0842122",
    "TaskId":"F6757FA4-8FED-4602-B7F5-3550C0842122"
}

错误码

HttpCode 错误码 错误信息 描述
503 ServiceUnavailable The request has failed due to a temporary failure of the server 请求失败,服务暂时不可用

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