扩容集群
接口说明
扩容集群 包含以下三种功能: 1、扩容节点数量 支持对数据节点、冷数据节点、协调节点进行节点数量变更,选直调模式 2、扩容节点规格 支持对数据节点、Kibana节点、冷数据节点、协调节点、专用主节点进行规格扩容,可选冷重启模式和蓝绿模式 3、扩容节点磁盘 支持对数据节点、冷数据节点进行磁盘扩容,可选直调模式和蓝绿模式
只填写需要修改的必填参数,不填写的参数默认为修改前参数,如果变配参数和修改前参数一致,会返回resize no change;
缩容集群 包含缩容节点规格和缩容磁盘 kibana仅支持缩规格,数据节点和冷数据节点支持缩规格、磁盘(冷数据节点仅支持缩磁盘大小)、节点数量,专有主节点支持缩规格,协调节点支持缩规格、节点数量
注意:缩节点数量调用的不是本接口而是/api/bes/cluster/v2/instance/delete删除节点v2接口
缩容节点规格时除了kibana节点外仅支持蓝绿和冷重启,kibana节点仅支持冷重启;缩容磁盘类型时仅支持冷重启和蓝绿,缩容磁盘大小和cdsIO时仅支持蓝绿
注意:缩cdsIO仅支持pl2磁盘
请求URI
POST /api/bes/cluster/resize
请求头参数
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
x-Region | String | 是 | 区域 | bd |
请求体参数
请求体字段数据结构说明
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
clusterId | String | 是 | 集群ID,超过规定18位会返回500错误 | 570900694777860096 |
modules | List |
是 | 模板信息 | |
paymentType | String | 是 | 计费方式 | postpay表示后付费、prepay表示预付费 |
coupon | String | 否 | 可用代金券,缩容和后付费不用传 | 123456 |
resizeMode | String | 是 | 扩容、升配方式,如果resizeMode为空会报"Http Message Not Readable"。SCROLL:滚动模式,SMOOTH:蓝绿模式,COLD:冷重启模式,HOT:直调模式 | SCROLL |
isShrink | Boolean | 否 | 升配false,降配true,默认为false | false |
ModulesItem字段数据结构说明
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
type | String | 否 | 节点类型,es_node:数据节点,kibana:kibana节点,es_dedicated_master:专用主节点,es_cold_tier_node:冷数据节点,es_coordinate_node:协调节点 | kibana |
version | String | 否 | 集群版本 | 7.4.2 |
desireInstanceNum | Integer | 否 | 节点数量 | 1 |
slotType | String | 否 | 机型 | bes.c3.c1m2 |
diskSlotInfo | DiskSlotInfo | 否 | 磁盘信息 |
DiskSlotInfo字段数据结构说明
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
type | String | 否 | 磁盘类型;磁盘类型;ssd表示高效云盘、premium_ssd表示ssd云盘 | premium_ssd |
size | BigDecimal | 否 | 磁盘大小;单位G 最小为50G premium_ssd最大为6144G ssd最大为20480G | 50 |
cdsExtraIo | BigDecimal | 否 | 预配置IO | 100 |
响应体参数
响应体字段数据结构说明
参数名称 | 参数类型 | 描述 | 示例值 |
---|---|---|---|
success | Boolean | 请求是否成功 | true |
status | Integer | 状态码 | 200 |
result | Result | 返回信息 |
Result字段数据结构说明
参数名称 | 参数类型 | 描述 | 示例值 |
---|---|---|---|
orderId | String | 订单ID | 186f2566f2884534a65ed8cdc2499d82 |
请求示例
POST /api/bes/cluster/resize
<公共请求头>
x-Region: bd
- 扩容节点数量
支持对数据节点、冷数据节点、协调节点进行节点数量变更,选直调模式
示例:
{
"clusterId" : "570900694777860096",
"isShrink": false,
"modules": [
{
"type": "es_node",
"desireInstanceNum": 5
}
],
"paymentType": "postpay",
"resizeMode": "HOT"
}
- 扩容节点规格
支持对数据节点、Kibana节点、冷数据节点、协调节点、专用主节点进行规格扩容,可选冷重启模式和蓝绿模式
示例:
{
"clusterId" : "570900694777860096",
"isShrink": false,
"modules": [
{
"type": "es_node",
"slotType": "bes.g3.c4m16"
}
],
"paymentType": "postpay",
"resizeMode": "SMOOTH"
}
- 扩容节点磁盘
支持对数据节点、冷数据节点进行磁盘扩容,可选直调模式和蓝绿模式
示例:
{
"clusterId" : "570900694777860096",
"isShrink": false,
"modules": [
{
"type": "es_node",
"diskSlotInfo": {
"size": 100
}
}
],
"paymentType": "postpay",
"resizeMode": "SMOOTH"
}
- 变更磁盘类型
支持对数据节点变更磁盘类型,升配磁盘类型的同时,支持调整磁盘大小,可选直调模式和蓝绿模式
示例:
{
"clusterId" : "570900694777860096",
"isShrink": false,
"modules": [
{
"type": "es_node",
"diskSlotInfo": {
"type":"enhanced_ssd_pl2",
"size": 500,
"cdsExtraIo": 100
}
}
],
"paymentType": "postpay",
"resizeMode": "SMOOTH"
}
响应示例
HTTP/1.1 200 OK
<公共响应头>
{
"result" : {
"orderId" : "186f2566f2884534a65ed8cdc2499d82"
},
"success" : true,
"status" : 200
}
错误码
请参考通用错误码