更新时间:2025-12-24 GMT+08:00

实例扩容(老规格)

功能介绍

实例扩容。

当前页面API为历史版本API,未来可能停止维护。请使用实例扩容

URI

POST /v2/{project_id}/instances/{instance_id}/extend

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方式请参见获取项目ID

instance_id

String

实例ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

new_spec_code

String

规格变更后的规格ID。

若只扩展磁盘大小,则规格ID保持和原实例不变。

new_storage_space

Integer

规格变更后的消息存储空间,单位:GB。

若扩展实例基准带宽,则new_storage_space不能低于基准带宽规定的最小磁盘大小。

oper_type

String

扩容类型。

新规格支持扩容类型:"horizontal"、"vertical"、"node"、"storage"四种类型。

new_broker_num

Integer

扩容后集群节点数。

new_product_id

String

新规格变更后的产品ID。

涉及垂直扩容场景,需指定该项。

产品ID可以从查询产品规格列表获取。

publicip_id

String

实例绑定的弹性IP地址的ID。

以英文逗号隔开多个弹性IP地址的ID。

如果开启了公网再进行扩容,需要填写此参数。

tenant_ips

Array of strings

创建节点可以手动指定实例节点的内网IP地址,仅支持指定IPv4地址。

指定内网地址数量必须小于等于购买的节点数量。

当小于购买的节点数量时,未指定的节点则随机分配。

second_tenant_subnet_id

String

实例扩容时新节点使用备用子网的id。

当实例扩容使用备用子网,则传入此值。

需要联系客服添加白名单才能传入此值。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

job_id

String

规格变更任务ID。

请求示例

按需实例扩容(老规格)。

POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/extend

{
  "new_spec_code" : "dms.instance.kafka.cluster.c3.mini",
  "new_storage_space" : 1000
}

响应示例

状态码: 200

实例扩容提交成功。

{
  "job_id" : "93b94287-728d-4bb1-a158-cb66cb0854e7"
}

状态码

状态码

描述

200

实例扩容提交成功。

错误码

请参见错误码