调用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

默认值：nis
SchedulerType String 否 pbs

调度器类型。取值范围：

  • pbs
  • slurm
  • opengridscheduler
  • deadline

默认值：pbs
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

默认值：NFS
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：账号节点、调度节点、登录节点、计算节点混合部署在一个节点上。

默认值：Standard
HaEnable Boolean 否 true

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

  • true：开启
  • false：不开启

默认值：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：镜像市场镜像

默认值：system
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：系统自动出价，跟随当前市场实际价格。

默认值：NoSpot
ComputeSpotPriceLimit String 否 0.034

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

计算节点是否支持超线程。取值范围：

  • true：支持
  • false：不支持

默认值：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

默认值：NFS
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：公有云集群

默认值：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取值为Year时：1~3
  • 当参数PriceUnit取值为Month时：1~9
  • 当参数PriceUnit取值为Hour时：1

  • 当参数PriceUnit取值为Week时：1~4

    默认值：1
PeriodUnit String 否 Year

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

  • Year
  • Month
  • Hour
  • Week

默认值：Month
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_ssd

其中cloud类型已停售。
SystemDiskSize Integer 否 40

系统盘大小。单位：GiB

取值范围：40~500

默认值：40
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万

默认值：PL1

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

IsComputeEss Boolean 否 false

是否启用弹性伸缩组。取值范围：

  • true：启用
  • false：未启用

默认值：false

返回数据

名称 类型 示例值 描述
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 请求失败，服务暂时不可用

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