更新时间:2024-04-08 GMT+08:00

实例规格变更

功能介绍

实例规格变更。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

engine

String

消息引擎的类型。支持的类型为rocketmq。

project_id

String

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

instance_id

String

实例ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

oper_type

String

变更类型

取值范围:

  • storage:存储空间扩容,代理数量不变。

  • horizontal:代理数量扩容,每个broker的存储空间不变。

  • vertical:垂直扩容,broker的底层虚机规格变更,代理数量和存储空间不变。

new_storage_space

Integer

当oper_type类型是storage或horizontal时,该参数有效且必填,实例存储空间 = 代理数量 * 每个broker的存储空间。

  • 当oper_type类型是storage时,代理数量不变,每个broker存储空间最少扩容100GB。

  • 当oper_type类型是horizontal时,每个broker的存储空间不变。

new_product_id

String

当oper_type类型是vertical时,该参数才有效且必填。

new_broker_num

Integer

代理数量

当oper_type参数为horizontal时,该参数必填。

publicip_id

String

实例绑定的弹性IP地址的ID。 以英文逗号隔开多个弹性IP地址的ID。 当oper_type参数为horizontal且开启了公网访问时,此参数必填。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

job_id

String

规格变更任务ID。

请求示例

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

{
  "oper_type" : "horizontal",
  "new_product_id" : "c6.4u8g.cluster"
}

响应示例

状态码: 200

实例规格变更成功。

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

状态码

状态码

描述

200

实例规格变更成功。

错误码

请参见错误码