调整集群节点
功能介绍
创建集群后，扩容/缩容集群Core节点或者Task节点。MRS集群创建成功后不支持调整Master节点数量，即不支持扩缩容Master节点。该接口不兼容Sahara。
处于running状态的集群才允许扩容/缩容，其他状态则不允许扩容/缩容。
URI
- URI格式
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
项目编号。获取方法，请参见获取项目ID。
cluster_id
是
集群ID。
请求消息
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
service_id |
否 |
String |
服务ID，为扩展接口，预留此参数。用户不需要配置。 |
|
plan_id |
否 |
String |
套餐ID，为扩展接口，预留此参数。用户不需要配置。 |
|
parameters |
是 |
Object |
核心参数，请参见表3。 |
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
order_id |
否 |
String |
扩容/缩容时系统获取的订单号，用户不需要配置。 |
|
scale_type |
是 |
String |
|
|
node_id |
是 |
String |
扩容/缩容时新增或者减少节点的ID标识，参数值固定为node_orderadd。 |
|
node_group |
否 |
String |
扩容或缩容的节点组。
该字段可以为空，为空时，系统默认值为core_node_default_group。 |
|
task_node_info |
否 |
Object |
Task节点规格。参数说明，请参见表5。
|
|
instances |
是 |
Integer |
扩容或缩容的节点数。 |
|
skip_bootstrap_scripts |
否 |
String |
仅在创建集群时配置了引导操作且扩容时有意义，表示扩容时是否在新增节点上执行创建集群时指定的引导操作。默认为false，即执行引导操作。 |
|
scale_without_start |
否 |
boolean |
扩容后是否启动扩容节点上的组件。
|
|
server_ids |
否 |
List<String> |
缩容Task节点时指定待删除Task节点的ID列表。
|
|
previous_values |
否 |
Object |
扩展参数，可以不用设置，请参见表4。 |
示例
- 请求样例
{ "service_id": "", "plan_id": "", "parameters": { "order_id": "", "scale_type": "scale_out", "node_id": "node_orderadd", "node_group": "core_node_default_group", "instances": "1", "skip_bootstrap_scripts":false, "scale_without_start":false }, "previous_values": { "plan_id": "" } }扩容Task节点（Task节点个数大于零时）样例：
{ "service_id": "", "plan_id": "", "parameters": { "order_id": "", "scale_type": "scale_out", "node_id": "node_orderadd", "node_group": "task_node_default_group", "instances": "1", "skip_bootstrap_scripts":false, "scale_without_start":false }, "previous_values": { "plan_id": "" } }扩容Task节点（Task节点个数为零时）样例：
{ "service_id": "", "plan_id": "", "parameters": { "order_id": "", "scale_type": "scale_out", "node_id": "node_orderadd", "node_group": "task_node_default_group", "task_node_info": { "node_size": "s3.xlarge.2.linux.bigdata", "data_volume_type":"SATA", "data_volume_count":2, "data_volume_size":600 }, "instances": "1", "scale_without_start":false }, "previous_values": { "plan_id": "" } }缩容Core节点样例：
{ "service_id": "", "plan_id": "", "parameters": { "order_id": "", "scale_type": "scale_in", "node_id": "node_orderadd", "node_group": "core_node_default_group", "instances": "1" }, "previous_values": { "plan_id": "" } }缩容Task节点样例：
{ "service_id": "", "plan_id": "", "parameters": { "order_id": "", "scale_type": "scale_in", "node_id": "node_orderadd", "node_group": "task_node_default_group", "instances": "1" }, "previous_values": { "plan_id": "" } }缩容指定的Task节点样例：{ "service_id": "", "plan_id": "", "parameters": { "order_id": "", "scale_type": "scale_in", "node_id": "node_orderadd", "node_group": "task_node_default_group", "instances": "2", "server_ids": ["c9573435-7814-4b2c-9131-ad78b814414c", "a4951009-6a0f-4e7b-9c81-9d4bd1f8c537"] }, "previous_values": { "plan_id": "" } }
- 响应样例
{ "result": "succeeded" }
状态码
- 状态码如表7所示。
- 操作失败时返回的错误码信息列表如表8所示。
表8 错误码说明 Error Code
Message
12000001
身份校验不合法。
12000002
参数不合法。
12000003
集群不存在。
12000009
方法参数不合法。
12000013
XX集群缩容失败。
12000014
XX集群扩容失败。
12000017
状态不是【运行中】的集群，不允许执行缩容/扩容操作。
12000018
缩容/扩容中的集群，不允许再次缩容/扩容。
12000019
获取集群主机列表失败！
12000028
集群Core节点个数最多为N个。
12000029
获取配额失败。
12000030
申请的集群节点总数大于可用配额数量。
12000031
申请的集群CPU总核数大于可用配额数量。
12000032
申请的集群内存总数大于可用配额数量。
12000033
申请的集群磁盘块数大于可用配额数量。
12000034
申请的集群磁盘容量大于可用配额数量。
12000054
不支持此操作。
12000067
集群版本太老，不允许扩容，请尽快升级最新版本。
12000068
集群存在非运行状态节点，请稍后重试。
12000121
该集群存在未支付订单，不允许扩容，请完成订单后再执行操作。
MRS.101
用户请求配额不足，请联系技术支持提升配额。
MRS.102
用户Token为空或不合法，请稍后重试或联系客服。
MRS.103
用户请求不合法，请稍后重试或联系客服。
MRS.104
用户资源不足，请稍后重试或联系客服。
MRS.105
现子网IP不足，请稍后重试或联系客服。
MRS.201
因ECS服务导致失败，请稍后重试或联系客服。(ECS:xxxx, ECS错误信息)
MRS.202
因IAM服务导致失败，请稍后重试或联系客服。(IAM:xxxx, IAM错误信息)。
MRS.203
因VPC服务导致失败，请稍后重试或联系客服。(VPC:xxxx,VPC错误信息)。
MRS.300
MRS内部出错，请稍后重试或联系客服。
- 异常状态码请参见状态码。
