创建集群
更新时间：2025-08-20
接口说明
创建集群
节点配置类型：参考https://cloud.baidu.com/doc/BES/s/tki03tbio
version说明： sdk支持的版本是'7.4.2'
集群中节点类型说明
| 序号 | 类型值 | 说明 | 是否必须 |
|---|---|---|---|
| 1 | es_node | es数据节点 | 是 |
| 2 | kibana | kibana节点 | 是 |
| 3 | es_dedicated_master | 专有主节点 | 否 |
| 4 | es_coordinate_node | 协调节点 | 否 |
| 5 | es_cold_tier_node | 冷节点 | 否 |
集群中节点磁盘类型说明
| 序号 | 类型值 | 说明 |
|---|---|---|
| 1 | premium_ssd | ssd云盘 |
| 2 | ssd | 高效云盘 |
| 3 | enhanced_ssd_pl1 | 增强型SSD_PL1 |
集群类节点支持的计算资源规格说明
| 数据节点 | Kibana | 专用主节点 | 冷数据节点 | 协调节点 |
|---|---|---|---|---|
| bes.g3.c2m8 | bes.g3.c2m8 | bes.g3.c2m8 | bes.g3.c2m8 | bes.g3.c2m8 |
| bes.g3.c4m16 | bes.g3.c4m16 | bes.g3.c4m16 | bes.g3.c4m16 | bes.g3.c4m16 |
| bes.g3.c8m32 | bes.g3.c8m32 | bes.g3.c8m32 | bes.g3.c8m32 | bes.g3.c16m64 |
| bes.g3.c16m64 | bes.c3.c2m4 | bes.g3.c16m64 | bes.g3.c16m64 | bes.g3.c16m64 |
| bes.g3.c32m128 | bes.c3.c4m8 | bes.g3.c16m64 | bes.g3.c16m64 | bes.g3.c32m128 |
| bes.c3.c2m4 | bes.c3.c8m16 | bes.c3.c32m64 | bes.g3.c32m128 | bes.c3.c2m4 |
| bes.c3.c4m8 | bes.c3.c8m16 | bes.c3.c2m4 | bes.c3.c4m8 | |
| bes.c3.c8m16 | bes.c3.c16m32 | bes.c3.c4m8 | bes.c3.c4m8 | |
| bes.c3.c16m32 | bes.m3.c4m32 | bes.c3.c16m32 | bes.c3.c8m16 | |
| bes.c3.c32m64 | bes.m3.c2m16 | bes.c3.c32m64 | bes.c3.c16m32 | |
| bes.ic3.c4m4 | bes.m3.c4m32 | bes.ic3.c4m4 | bes.c3.c32m64 | |
| bes.ic3.c8m8 | bes.m3.c8m64 | bes.ic3.c8m8 | bes.ic3.c4m4 | |
| bes.ic3.c12m12 | bes.ic3.c12m12 | bes.ic3.c8m8 | ||
| bes.ic3.c16m16 | bes.ic3.c16m16 | bes.ic3.c12m12 | ||
| bes.m3.c2m16 | bes.m3.c2m16 | bes.ic3.c16m16 | ||
| bes.m3.c4m32 | bes.m3.c4m32 | bes.m3.c4m32 | ||
| bes.m3.c8m64 | bes.m3.c8m64 | bes.m3.c8m64 |
集群各类节点支持的存储资源说明：
| 序号 | 节点类型 | 说明 |
|---|---|---|
| 1 | es数据节点 | 支持ssd云盘、高效云盘，最小50GB |
| 2 | Kibana | 无；不需要设置 |
| 3 | 专用主节点 | ssd云盘，大小20GB |
| 4 | 冷数据节点 | 高性能云盘，最小50GB |
| 5 | 协调节点 | 高性能云盘，大小20GB |
请求URI
POST /api/bes/cluster/create
请求头参数
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| x-Region | String | 是 | 区域 | bd |
请求体参数
请求体字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| name | String | 是 | 集群名称 | postpaynew1 |
| password | String | 是 | 集群密码 | 123456aA |
| securityGroupId | String | 是 | 安全组ID | g-s77w7h0ierks |
| subnetUuid | String | 是 | 子网ID | sbn-38zqasty2i8n |
| availableZone | String | 是 | 可用区 | cn-bd-b |
| vpcId | String | 是 | 虚拟网络ID | vpc-5dd5bib4h0vc |
| isOldPackage | Boolean | 否 | 区分新老套餐 (true表示老套餐、false表示新套餐)；默认是false | false |
| version | String | 是 | 集群版本 | 7.4.2 |
| modules | List |
是 | 节点信息 | |
| billing | Billing | 是 | 集群计费信息 | |
| tags | List |
否 | 选择标签 | [{"testKey":"key",testValue:"value'}] |
| enableSSL | Boolean | 否 | 是否开启https | false |
| resGroupId | String | 否 | 资源分组id | RESG-44pvmsruNiy |
ModulesItem字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| instanceNum | Integer | 是 | 节点数量 | 2 |
| slotType | String | 是 | 资源配置类型； | bes.c3.c2m4 |
| diskSlotInfo | DiskSlotInfo | 是 | 磁盘信息（新套餐必需，老套餐不需要） | |
| type | String | 是 | 节点类型 | kibana |
DiskSlotInfo字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| size | Integer | 是 | 磁盘大小；单位G 最小为50G premium_ssd最大为6144G ssd最大为20480G | 50 |
| type | String | 是 | 磁盘类型；磁盘类型；ssd表示高效云盘、premium_ssd表示ssd云盘 | premium_ssd |
| cdsExtraIo | Integer | 是 | 预配置io，只有pl2磁盘可配置 | 11 |
Billing字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| paymentType | String | 是 | 计费方式;postpay表示后付费、prepay表示预付费 | postpay |
| time | Integer | 否 | 购买时长（后付费时time参数设置为0），单位是月 | 0 |
| enableAutoRenew | Boolean | 否 | 是否开启自动续费 | true |
| autoRenewInfo | AutoRenewInfo | 否 | 自动续费信息 | |
| coupon | String | 否 | 可用代金券 | 123456 |
AutoRenewInfo字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| renewTimeUnit | String | 否 | 自动续费单位，month：月，year：年 | month |
| renewTime | BigDecimal | 否 | 自动续费时间，可填1-9个月、1-3年 | 1 |
TagsItem字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| field_2 | String | 是 | ||
| field_3 | String | 是 |
响应体参数
响应体字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| success | Boolean | 请求是否成功 | true |
| status | Integer | 状态码 | 200 |
| result | Result | 返回信息 |
请求示例
Plain Text
1POST /api/bes/cluster/create
2<公共请求头>
3x-Region: bd
4
5
6示例：
7{
8 "name": "postpaynew1",
9 "password": "123456aA",
10 "securityGroupId": "g-s77w7h0ierks",
11 "subnetUuid": "sbn-38zqasty2i8n",
12 "availableZone": "cn-bd-b",
13 "vpcId": "vpc-5dd5bib4h0vc",
14 "isOldPackage": false,
15 "version": "7.4.2",
16 "modules": [
17 {
18 "instanceNum": 2,
19 "slotType": "bes.g3.c2m8",
20 "diskSlotInfo": {
21 "size": 50,
22 "type": "premium_ssd"
23 },
24 "type": "es_node"
25 }, {
26 "instanceNum": 3,
27 "slotType": "bes.g3.c2m8",
28 "diskSlotInfo": {
29 "size": 20,
30 "type": "premium_ssd"
31 },
32 "type": "es_dedicated_master"
33 }, {
34 "instanceNum": 3,
35 "slotType": "bes.g3.c2m8",
36 "diskSlotInfo": {
37 "size": 50,
38 "type": "ssd"
39 },
40 "type": "es_cold_tier_node"
41 }, {
42 "instanceNum": 1,
43 "slotType": "bes.g3.c2m8",
44 "diskSlotInfo": {
45 "size": 20,
46 "type": "ssd"
47 },
48 "type": "es_coordinate_node"
49 },
50 {
51 "instanceNum": 1,
52 "slotType": "bes.c3.c2m4",
53 "type": "kibana"
54 }
55 ],
56 "billing": {
57 "paymentType": "postpay",
58 "time": 0,
59 "enableAutoRenew":true,
60 "autoRenewInfo":{
61 "renewTimeUnit":"month",
62 "renewTime":1
63 }
64 },
65 "tags":[
66 {
67 "tagKey":"key",
68 "tagValue":"value"
69 }
70 ]
71}响应示例
Plain Text
1HTTP/1.1 200 OK
2<公共响应头>
3
4{
5 "result" : { },
6 "success" : true,
7 "status" : 200
8}错误码
请参考通用错误码