创建集群

更新时间：2026-09-16

接口描述

创建一个用户指定配置的集群。

注意：

用户创建集群前，需要开通CHPC服务。

请求结构

Bash

1POST /v{version}/cluster HTTP/1.1
2Host: chpc.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其他特殊头域。

请求参数

参数类别	字段名称	示例值	说明
集群基础配置	`clusterType`	`cloud`	集群类型：`cloud` 云上 / `onprem` 本地
集群基础配置	`clusterName`	`test_private2`	集群名称
集群基础配置	`zoneName`	`cn-cnhzpro-a`	所属可用区
集群基础配置	`vpcId`	`vpc-edg55g9vdj5t`	使用的 VPC 网络 ID
集群基础配置	`securityGroupType`	`normal`	安全组类型：`normal` 或 `enterprise`
集群基础配置	`securityGroupId`	`g-azg9b45a9n2t`	安全组 ID
集群基础配置	`schedulerType`	`slurm`	调度器类型，如 `slurm`
集群基础配置	`schedulerVersion`	`22.05.9`	调度器版本号
集群基础配置	`keypairId`	`k-WwNR90Ip`	登录密钥对 ID
集群基础配置	`forbidDelete`	`true`	是否开启删除保护
集群基础配置	`maxNodes`	`1000`	最大节点数限制
集群基础配置	`maxCpus`	`10000`	最大 CPU 数限制
集群基础配置	`tags`	`[{"tagKey":"默认项目","tagValue":""}]`	集群标签列表
主节点配置	`masterSpec.subnetId`	`sbn-cigjjybje0jv`	子网 ID
主节点配置	`masterSpec.chargeType`	`Postpaid`	计费方式：按量付费（Postpaid）或包年包月
主节点配置	`masterSpec.spec`	`bcc.g4.c1m1`	实例规格
主节点配置	`masterSpec.count`	`1`	主节点个数
主节点配置	`masterSpec.imageId`	`1f121e8c-...`	镜像 ID
主节点配置	`masterSpec.osItem.osName`	`CentOS`	操作系统名称
主节点配置	`masterSpec.osItem.osVersion`	`7.9 x86_64 (64bit)`	操作系统版本
主节点配置	`masterSpec.systemDisk.storageType`	`premium_ssd`	系统盘类型
主节点配置	`masterSpec.systemDisk.size`	`100`	系统盘大小（GB）
主节点配置	`masterSpec.systemDisk.cdsNum`	`1`	系统盘个数
主节点配置	`masterSpec.dataDiskList`	`[]`	数据盘列表（可为空）
主节点配置	`masterSpec.tags`	`[{"tagKey":"默认项目","tagValue":""}]`	标签配置
挂载配置	`mountList[0].cfsId`	`cfs-VX6brH6rHn`	文件系统 ID
挂载配置	`mountList[0].mountPoint`	`cfs-VX6brH6rHn.lb-89fa0b27.x1.dxmyun.com`	挂载点地址
挂载配置	`mountList[0].mountDirectory`	`/home`	节点中挂载目录
挂载配置	`mountList[0].fileSystem`	`/`	文件系统根路径
队列配置	`queueList[0].queueName`	`defaultQueue`	队列名称
队列配置	`queueList[0].isDefault`	`true`	是否为默认队列
队列配置	`queueList[0].nodeCount`	`0`	初始节点数
队列配置	`queueList[0].minNodesInQueue`	`0`	队列最小节点数
队列配置	`queueList[0].maxNodesInQueue`	`0`	队列最大节点数
队列配置	`queueList[0].maxScalePerCycle`	`0`	每次最大扩容节点数
队列配置	`queueList[0].enableAutoGrow`	`false`	是否自动扩容
队列配置	`queueList[0].enableAutoShrink`	`false`	是否自动缩容
队列配置	`queueList[0].isAutoScale`	`false`	是否启用弹性伸缩
队列配置	`queueList[0].computeSpec.subnetId`	`""`	子网 ID（可为空）
队列配置	`queueList[0].computeSpec.count`	`0`	节点数量
队列配置	`queueList[0].computeSpec.systemDisk.cdsNum`	`1`	系统盘个数
队列配置	`queueList[0].computeSpec.dataDiskList`	`[]`	数据盘列表
队列配置	`queueList[0].tags`	`[{"tagKey":"默认项目","tagValue":""}]`	队列标签配置

响应头域

除公共头域外，无其他特殊头域。

响应参数

参数名称	类型	描述
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 为空。

请求示例

                JSON
                
            

                POST /v1/cluster
Host: chpc.bj.baidubce.com
Authorization: bce-auth-v1/ALTAKfdDegfDEgedgyhted54dg/2023-08-22T09:48:15Z/1800/host/2fab6012ac3ba584ba990d5773bb56e5ce8e7f466398220c2842d33d02c6818a
{
    "clusterType": "cloud",
    "clusterName": "test_private2",
    "zoneName": "cn-cnhzpro-a",
    "vpcId": "vpc-edg55g9vdj5t",
    "securityGroupType": "normal",
    "securityGroupId": "g-azg9b45a9n2t",
    "schedulerType": "slurm",
    "schedulePlugin": 1,
    "schedulePluginVersion": "0.1.0",
    "schedulerVersion": "22.05.9",
    "masterSpec": {
        "subnetId": "sbn-cigjjybje0jv",
        "chargeType": "Postpaid",
        "spec": "bcc.g4.c1m1",
        "count": 1,
        "imageId": "1f121e8c-418d-48c9-9b59-7009ee3a01ae",
        "osItem": {
            "imageId": "1f121e8c-418d-48c9-9b59-7009ee3a01ae",
            "osName": "CentOS",
            "osVersion": "7.9 x86_64 (64bit)"
        },
        "systemDisk": {
            "storageType": "premium_ssd",
            "size": 100,
            "cdsNum": 1
        },
        "dataDiskList": [],
        "tags": [
            {
                "tagKey": "默认项目",
                "tagValue": ""
            }
        ]
    },
    "keypairId": "k-WwNR90Ip",
    "forbidDelete": true,
    "maxNodes": 1000,
    "maxCpus": 10000,
    "tags": [
        {
            "tagKey": "默认项目",
            "tagValue": ""
        }
    ],
    "mountList": [
        {
            "cfsId": "cfs-VX6brH6rHn",
            "mountPoint": "cfs-VX6brH6rHn.lb-89fa0b27.x1.dxmyun.com",
            "mountDirectory": "/home",
            "fileSystem": "/"
        }
    ],
    "softwareList": [],
    "queueList": [
        {
            "queueName": "defaultQueue",
            "isDefault": true,
            "nodeCount": 0,
            "vpc": "vpc",
            "minNodesInQueue": 0,
            "maxNodesInQueue": 0,
            "maxScalePerCycle": 0,
            "subnetId": "",
            "subnetName": "",
            "enableAutoGrow": false,
            "enableAutoShrink": false,
            "isAutoScale": false,
            "computeSpec": {
                "subnetId": "",
                "count": 0,
                "systemDisk": {
                    "cdsNum": 1
                },
                "dataDiskList": []
            },
            "tags": [
                {
                    "tagKey": "默认项目",
                    "tagValue": ""
                }
            ]
        }
    ]
}
            

响应示例

                JSON
                
                {
    "requestId": "ae0bb335-1a55-4aa9-9807-1963ac8063b1",
    "clusterId": "c-AgDlAdOk"
}

评价此篇文章

有帮助没帮助

公共请求头与响应头

释放集群

百度智能云

云高性能计算平台 CHPC

云高性能计算平台 CHPC

创建集群

接口描述

请求结构

请求头域

请求参数

响应头域

响应参数

错误码

请求示例

响应示例