全部产品
云市场

CreateCluster

更新时间:2018-11-14 17:44:27

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

描述

在创建集群前,您可以:

创建实例会涉及到资源计费,建议您提前了解弹性高性能计算 E-HPC 的计费方式。更多详情,请参阅 计费方式

请求参数

名称 类型 是否必需 默认值 描述
Action String - 操作接口名,系统规定参数,取值:CreateCluster
RegionId String - 地域 ID。
ZoneId String - 可用区 ID。
Name String - 集群名字。长度2-64字符,只允许包含中文、字母、数字、短横线(-)和下划线(_),必须以字母或中文开头。
Description String 集群描述,2~128个字符。
EhpcVersion String - E-HPC产品版本号,目前支持1.0.0
OsTag String - 操作系统镜像标签,可以调用 ListImages 接口进行查询。
SchedulerType String pbs 调度器类型,目前支持 pbs。
AccountType String nis 域账号服务类型,目前支持 nis。
Application.n.Tag String - 第 n 个(n 从 1 开始编号,可以有多条)应用软件的标签(SoftwareTag),软件标签可以用 ListSoftwares 接口查询得到。例如 OpenMPI_11.1
SecurityGroupId String 使用已有安全组的安全组 Id。
SecurityGroupName String 如果不使用已有安全组(SecurityGroupId为空),则使用这个名字创建新安全组,应用默认策略。格式要求参考 ECS 安全组名字。
VSwitchId String - VPC 中交换机 ID。产品目前只支持 VPC 网络。
VolumeType String nas 网络共享存储类型,目前仅支持阿里云 NAS。
VolumeId String - 阿里云 NAS 实例 Id。目前不支持自动创建阿里云 NAS 实例。
VolumeProtocol String nfs 网络共享存储协议,目前仅支持 nfs。
VolumeMountpoint String - NAS vpc 挂载点。目前不支持自动创建阿里云 NAS 挂载点。
RemoteDirectory String - 挂载共享存储的远程目录。最终挂载路径为挂载点与远程目录组合:NasMountpoint:/RemoteDirectory
HaEnable Boolean false 是否开启高可用,若开启,集群中的每种管控角色将会使用主备 2 台实例。
EcsChargeType String PostPaid 集群使用 ECS 实例的付费类型,PostPaid:按量付费,PrePaid:包年包月。若选择包年包月类型,默认开启自动续费,节点释放后将关闭自动续费。
EcsOrder.Manager.InstanceType String - 集群管控节点实例规格。
EcsOrder.Compute.Count Integer - 集群计算节点数量,取值范围:1-99。
EcsOrder.Compute.InstanceType String - 集群计算节点实例规格。
EcsOrder.Login.Count Integer 集群登录节点数量,取值范围:1-99。
EcsOrder.Login.InstanceType String - 集群登录节点实例规格。
Password String 否,同KeyPairName二选一 跳板机(Login 节点)的 root 密码。8-30个字符,必须同时包含三项(大、小写字母,数字和特殊符号)。支持以下特殊字符:( ) ` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ‘ < > , . ? / 请务必使用HTTPS协议调用API以避免可能发生的密码泄露。
KeyPairName String 否,同Password二选一 密钥对名称。要使用 ECS 密钥对功能,请在 ECS 控制台创建密钥对。
SccClusterId String 当使用 SCC 机型时,如果传入此字段,则使用指定的 SccCluster 创建 Scc 实例,否则将替用户创建实例。
ComputeSpotStrategy String - 计算节点竞价策略,取值NoSpotSpotWithPriceLimitSpotAsPriceGo
ComputeSpotPriceLimit String - 设置实例的每小时最高价格,取值是浮点数,取值范围是当前的价格区间。
ImageOwnerAlias String system 镜像类型,systemselfothersmarketplace
ImageId String - 镜像 Id, 如果 ImageTypesystem, 就只根据 OsTag 来决定基础镜像ID; 如果是selfothersmarketplaceImageId 就是必填的。
DeployMode String Standard 部署模式:
Standard: 账号节点 + 调度节点 + 登录节点 + 计算节点
Advanced: HA模式
Simple: (账号 + 调度)节点 + 登录节点 + 计算节点
Tiny:(账号 + 调度 + 登录)节点 + 计算节点
OneBox:(账号 + 调度 + 登录 + 计算)节点 + 更多计算节点
PostInstallScript.n.Url String - 第 n 个(n 从 1 开始编号,可以有多条,最大 16 条)安装后脚本的下载地址。
PostInstallScript.n.Args String - 第n个(n 从 1 开始编号,可以有多条,最大 16 条)安装后脚本的执行参数。
Period Integer - 购买资源的时长,单位为:月。当参数 EcsChargeType 取值为 PrePaid 时才生效且为必选值。
PeriodUnit String - 购买资源的时长。可选值 WeekMonth
AutoRenew Boolean false true:自动续费;false:不自动续费。
AutoRenewPeriod Integer 1 每次自动续费的时长,当参数 AutoRenew 取值 True 时生效。
JobQueue String - 计算节点加入的队列

返回参数

公共返回参数外返回如下结果:

名称 类型 描述
ClusterId String 集群 Id。

示例

请求示例

  1. https://ehpc.cn-hangzhou.aliyuncs.com/?Action=CreateCluster&RegionId=cn-hangzhou&Name=<集群名称>&Ehpcversion=1.0.23&OsTag=CentOS_7.2_64&Password=<集群密码>&<公共请求参数>

返回示例

XML格式

  1. <CreateClusterResponse>
  2. <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
  3. <ClusterId>ehpc-hz-3eniOe7wA6</ClusterId>
  4. </CreateClusterResponse>

JSON格式

  1. {
  2. "ClusterId": "ehpc-hz-3eniOe7wA6",
  3. "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
  4. }

错误码

查询 E-HPC 接口错误码请访问 错误码。更多错误码,请访问 API 错误中心