创建集群

更新时间：2025-04-01

接口说明

创建集群

节点配置类型：参考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	返回信息

请求示例

POST /api/bes/cluster/create
<公共请求头>
x-Region: bd


示例：
{
  "name": "postpaynew1",
  "password": "123456aA",
  "securityGroupId": "g-s77w7h0ierks",
  "subnetUuid": "sbn-38zqasty2i8n",
  "availableZone": "cn-bd-b",
  "vpcId": "vpc-5dd5bib4h0vc",
  "isOldPackage": false,
  "version": "7.4.2",
  "modules": [
    {
      "instanceNum": 2,
      "slotType": "bes.g3.c2m8",
      "diskSlotInfo": {
        "size": 50,
        "type": "premium_ssd"
      },
      "type": "es_node"
    }, {
      "instanceNum": 3,
      "slotType": "bes.g3.c2m8",
      "diskSlotInfo": {
        "size": 20,
        "type": "premium_ssd"
      },
      "type": "es_dedicated_master"
    }, {
      "instanceNum": 3,
      "slotType": "bes.g3.c2m8",
      "diskSlotInfo": {
        "size": 50,
        "type": "ssd"
      },
      "type": "es_cold_tier_node"
    }, {
      "instanceNum": 1,
      "slotType": "bes.g3.c2m8",
      "diskSlotInfo": {
        "size": 20,
        "type": "ssd"
      },
      "type": "es_coordinate_node"
    },
    {
      "instanceNum": 1,
      "slotType": "bes.c3.c2m4",
      "type": "kibana"
    }
  ],
  "billing": {
    "paymentType": "postpay",
    "time": 0,
    "enableAutoRenew":true,
    "autoRenewInfo":{
        "renewTimeUnit":"month",
        "renewTime":1
    }
  },
  "tags":[
  	{
  		"tagKey":"key",
  		"tagValue":"value"
  	}
  	]
}

响应示例

HTTP/1.1 200 OK
<公共响应头>

{
  "result" : { },
  "success" : true,
  "status" : 200
}

错误码

请参考通用错误码

用户可用代金券列表

查看集群列表

百度智能云

Elasticsearch BES

Elasticsearch BES

创建集群

接口说明

请求URI

请求头参数

请求体参数

响应体参数

请求示例

响应示例

错误码