调用CreateHybridCluster创建一个混合云集群。

调试

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

请求参数

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

系统规定参数。取值：CreateHybridCluster
EcsOrder.Compute.InstanceType String 是 ecs.n1.tiny

集群计算节点实例规格。
Name String 是 hybridcluster

集群名称。长度2~64字符，只允许包含中文、字母、数字、短划线（-）和下划线（_），必须以字母或中文开头。
OsTag String 是 CentOS_7.2_64

操作系统镜像标签，您可以调用ListImages接口查询。

VpcId String 是 vpc-b3f3edefefeep0760yju****

集群所属的VPC ID。
VSwitchId String 是 vsw-bp1lfcjbfb099rrjn****

交换机ID。
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

集群客户端版本。默认使用最新版本。
Domain String 否 nis

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

  • nis
  • ldap

默认值：nis
Nodes.N.HostName String 否 test1

第N个本地集群节点的主机名称。
Nodes.N.IpAddress String 否 00b648b****

第N个本地集群节点的IP地址。
Nodes.N.Role String 否 Compute

第N个本地集群节点的角色。取值范围：

  • Manager：管控节点
  • Login：登录节点
  • Compute：计算节点
Nodes.N.AccountType String 否 nis

第N个本地集群节点的域账号服务类型。取值范围：

  • nis
  • ldap

默认值：nis
Nodes.N.SchedulerType String 否 pbs

第N个本地集群节点的调度器类型。取值范围：

  • pbs
  • slurm
  • opengridscheduler
  • deadline

默认值：pbs
Location String 否 OnPremise

集群所在的位置。位置固定为混合云集群，取值：OnPremise。
SecurityGroupId String 否 sg-bp13n61xsydodfyg****

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

说明 当指定该参数时，不能同时指定SecurityGroupName参数。
SecurityGroupName String 否 ehpc-SecurityGroup

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

说明 当指定该参数时，不能同时指定SecurityGroupId参数。
VolumeType String 否 NAS

文件系统类型。目前仅支持NAS。
VolumeId String 否 008b64****

存储实例ID。目前不支持自动创建阿里云NAS实例。
VolumeProtocol String 否 NFS

共享存储的协议类型。目前仅支持NFS。
VolumeMountpoint String 否 008b648bcb-s****.cn-hangzhou.nas.aliyuncs.com

NAS的VPC挂载点。目前不支持自动创建阿里云NAS挂载点。
RemoteDirectory String 否 NasMountpoint:/RemoteDirectory

挂载文件系统的远程目录。
OnPremiseVolumeProtocol String 否 NFS

本地共享存储协议。目前仅支持NFS。
OnPremiseVolumeMountPoint String 否 RemoteNasDomain.com

本地文件系统挂载点。
OnPremiseVolumeRemotePath String 否 /RemoteDirectory

本地文件系统挂载路径。
OnPremiseVolumeLocalPath String 否 /OnCloudDirectory

本地文件系统挂载到云上节点的路径。
Password String 否 123****

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

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

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

说明 如果您要使用ECS密钥对功能，具体操作，请参见创建密钥对。
Application.N.Tag String 否 OpenMPI_11.1

第N个应用软件的标签。N的取值范围：1~5
PostInstallScript.N.Url String 否 /opt/job.sh

第N个安装后脚本的全路径。N的取值范围：1~16
PostInstallScript.N.Args String 否 bash file.sh

第N个安装后脚本的执行参数。N的取值范围：1~16
JobQueue String 否 workq

扩容节点默认加入的队列。
ResourceGroupId String 否 rg-acfmxazb4ph****

资源组ID。
SchedulerPreInstall Boolean 否 true

业务镜像是否已预安装调度器。取值范围：

  • true：已预安装，创建或扩容节点时无需执行安装调度器流程。
  • false：未预安装，创建或扩容节点时需要执行安装调度器流程。
ComputeSpotStrategy String 否 NoSpot

计算节点抢占策略。取值范围：

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

默认值：NoSpot
ComputeSpotPriceLimit Float 否 0.034

计算节点下ECS实例的每小时最高价格。支持最多3位小数，参数ComputeSpotStrategy取值为SpotWithPriceLimit时生效。
ImageOwnerAlias String 否 system

镜像类型。取值范围：

  • system：公共镜像
  • self：自定义镜像
  • others：共享镜像
  • marketplace：镜像市场镜像
ImageId String 否 wi_1607_x64_dtc_zh_40G_alibase****

镜像ID。
ClientToken String 否 123e4567-e89b-12d3-a456-426655440000

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

MultiOs 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=CreateHybridCluster
&Name=hybridcluster
&EcsOrder.Compute.InstanceType=ecs.n1.tiny
&OsTag=CentOS_7.2_64
&VpcId=vpc-b3f3edefefeep0760yju****
&VSwitchId=vsw-bp1lfcjbfb099rrjn****
&<公共请求参数>

正常返回示例

XML格式 

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

JSON格式 

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

错误码

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

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