创建集群
更新时间：2024-09-25
接口描述
创建一个用户指定配置的集群。
注意：
用户创建集群前，需要开通CHPC服务。
请求结构
POST /v{version}/cluster HTTP/1.1
Host: chpc.bj.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | Integer | 是 | URL参数 | API版本号。例如1，如/v1/cluster |
| clientToken | String | 否 | URL参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串。 |
| clusterName | String | 是 | RequestBody参数 | 集群名称，长度为2~15个字符。集群名称只能包含英文大小写字母、数字、和_ 。必须以英文字母开头，英文或数字结尾。 |
| description | String | 否 | RequestBody参数 | 集群描述 |
| chargeType | String | 否 | RequestBody参数 | 集群中所有节点的付费类型，取值范围：Postpaid：按量付费Prepaid：包年包月默认Postpaid |
| period | Integer | 否 | RequestBody参数 | 购买集群节点的时长。单位由periodUnit指定，取值范围：当参数priceUnit取值为Year时：1~3。当参数priceUnit取值为Month时：1~9。默认值：1。 |
| periodUnit | Integer | 否 | RequestBody参数 | 购买集群节点的时长单位。取值范围：YearMonth默认值：Month。 |
| autoRenew | Boolean | 否 | RequestBody参数 | 是否自动续费，取值范围true：自动续费false：不自动续费默认值：false |
| autoRenewPeriod | Integer | 否 | RequestBody参数 | 自动续费时长。默认为1 |
| autoRenewPeriodUnit | String | 否 | RequestBody参数 | 自动续费时长单位。默认为Month |
| zoneName | String | 是 | RequestBody参数 | 可用区名字，如cn-bj-d |
| managerSpec | String | 是 | RequestBody参数 | 管控节点规格，如bcc.g5.c16m64 |
| computeSpec | String | 否 | RequestBody参数 | 计算节点规格，如bcc.c5.c32m64 |
| computeCount | Integer | 否 | RequestBody参数 | 计算节点数量，取值范围[1-100]默认1 |
| systemDiskSize | Integer | 否 | RequestBody参数 | 系统盘大小，默认40，单位GB |
| systemDiskType | Integer | 否 | RequestBody参数 | 系统盘类型，可选类型参考 StorageType默认cloud_hp1 |
| dataDiskCount | Integer | 否 | RequestBody参数 | 每个节点数据盘个数，默认0个 |
| dataDiskSize | Integer | 否 | RequestBody参数 | 数据盘大小，默认0，单位GB，不创建数据盘 |
| dataDiskType | String | 否 | RequestBody参数 | 数据盘类型，可选类型StorageType默认空 |
| managerImageId | String | 是 | RequestBody参数 | 管控镜像ID |
| computeImageId | String | 否 | RequestBody参数 | 计算节点镜像ID |
| keypairId | String | 否 | RequestBody参数 | 密钥对登录 |
| schedulerType | String | 否 | RequestBody参数 | 用户可选slurm默认slurm |
| cfsId | String | 否 | RequestBody参数 | 共享存储cfsId例如：cfs-6B76rTO4vS |
| cfsMountPoint | String | 否 | RequestBody参数 | cfs挂载点例如：cfs-6B76rTO4vS.lb-c659e6c1.cfs.bj.baidubce.com |
| mountDirectory | String | 否 | RequestBody参数 | 挂载共享存储的目录默认：/mnt/cfs |
| networkCapacityInMbps | Integer | 否 | RequestBody参数 | 管控节点公网带宽。默认值0，表示不使用公网 |
| internetChargeType | String | 否 | RequestBody参数 | 公网带宽计费方式，可选参数详见internetChargeType，若不指定internetChargeType，默认付费方式同BCC，预付费默认为包年包月按带宽，后付费默认为按使用带宽计费。当networkCapacityInMbps大于0时，此参数生效。BANDWIDTH_PREPAID 预付费按带宽结算TRAFFIC_POSTPAID_BY_HOUR 流量按小时后付费BANDWIDTH_POSTPAID_BY_HOUR 带宽按小时后付费 |
| eipName | String | 否 | RequestBody参数 | 长度1～65个字节，字母开头，可包含字母数字-_/.字符。若不传该参数，服务会自动生成name。 |
| vpcId | String | 是 | RequestBody参数 | 新创建集群所属的VPC ID |
| securityGroupId | String | 是 | RequestBody参数 | 指定新创建集群所属的安全组ID,安全组需要开通所有端口号 |
| subnetId | String | 是 | RequestBody参数 | 新建集群的子网ID |
响应头域
除公共头域外，无其他特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 请求ID |
| clusterId | String | 集群ID |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| BadRequest | computeSpec is empty. | 400 | 计算节点规格为空。 |
| BadRequest | The chargeType only support: Postpaid,Prepaid | 400 | 付费方式只支持后付费和预付费。 |
| BadRequest | zoneName should not empty. | 400 | zoneName 不应该为空。 |
| BadRequest | zoneName illegal. | 400 | zoneName非法 |
| BadRequest | cfsId is empty. | 400 | cfsId 为空。 |
请求示例
POST /v1/cluster
Host: chpc.bj.baidubce.com
Authorization: bce-auth-v1/ALTAKfdDegfDEgedgyhted54dg/2023-08-22T09:48:15Z/1800/host/2fab6012ac3ba584ba990d5773bb56e5ce8e7f466398220c2842d33d02c6818a
{
"clusterName": "test_chpc",
"description": "descriptiontest",
"zoneName": "cn-bj-g",
"managerSpec": "bcc.g5.c2m8",
"computeSpec": "bcc.g5.c2m8",
"vpcId": "vpc-xqcev5h16hir",
"subnetId": "sbn-4ggfji6pcmic",
"securityGroupId": "g-nhycu70gh3cr",
"systemDiskSize": 50,
"managerImageId": "m-3GFgXfwI",
"computeImageId": "m-3GFgXfwI"
}响应示例
{
"requestId": "ae0bb335-1a55-4aa9-9807-1963ac8063b1",
"clusterId": "c-AgDlAdOk"
}