Help Center/Distributed Message Service for RabbitMQ/API Reference/APIs V2 (Recommended)/Specification Modification Management/Modifying Specifications of Instances with New Flavors
Updated on 2025-12-29 GMT+08:00
View PDF

Modifying Specifications of Instances with New Flavors

Function

This API is used to modify instance specifications.

Currently, this API can only be used to modify specifications of pay-per-use instances.

Calling Method

For details, see Calling APIs.

URI

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

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details, see Obtaining a Project ID.

instance_id

Yes

String

Instance ID.

engine

Yes

String

Message engine, which is rabbitmq.

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

oper_type

Yes

String

Change type.

Value range:

storage: Expand the storage without changing the broker quantity.

horizontal: Add brokers without resizing the storage space of each broker.

vertical: Scale up the broker flavor without changing the broker quantity and storage.

new_storage_space

No

Integer

New storage space. Note that the disk capacity can only be set to an integer multiple of 100.

This parameter is valid and mandatory when oper_type is set to storage or horizontal.

Instance storage space =Number of brokers × Storage space of each broker.

  • If oper_type is set to storage, the number of brokers remains unchanged, and the storage space of each broker must be expanded by at least 100 GB.

  • If oper_type is set to horizontal, the storage space of each broker remains unchanged.

new_product_id

No

String

Flavor, such as c6.8u16g.cluster. This parameter is valid and mandatory when oper_type is set to vertical.

new_broker_num

No

Integer

This parameter is valid only when oper_type is set to horizontal.

new_spec_code

No

String

Old flavor, such as dms.instance.rabbitmq.cluster.c3.8u16g. When oper_type is set to horizontal, the value is dms.instance.rabbitmq.cluster.c3.8u16g.5 (5 is the broker quantity.)

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

job_id

String

ID of the specification modification task.

Example Requests

  • Expanding the storage space (pay-per-use, old flavors). new_spec_code is the original specification.

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

{
  "new_storage_space" : 600,
  "oper_type" : "storage",
  "new_spec_code" : "dms.instance.rabbitmq.cluster.c3.2u4g.3"
}

  • Adding brokers (pay-per-use, old flavors). new_storage_space is the space of the original specification. new_spec_code is dms.instance.rabbitmq.cluster.c3.2u4g.5 (5 is the broker quantity.)

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

{
  "new_storage_space" : 600,
  "oper_type" : "horizontal",
  "new_spec_code" : "dms.instance.rabbitmq.cluster.c3.2u4g.5"
}

  • Increasing broker flavors (pay-per-use, old flavors). For new_spec_code, replace the original specification with the new one. For example, replace 2u4g with 4u8g.

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

{
  "new_storage_space" : 600,
  "oper_type" : "vertical",
  "new_spec_code" : "dms.instance.rabbitmq.cluster.c3.2u4g.5"
}

  • Expanding the storage space (pay-per-use)

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

{
  "new_storage_space" : 600,
  "oper_type" : "storage"
}

  • Adding brokers (pay-per-use)

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

{
  "oper_type" : "horizontal",
  "new_storage_space" : 500,
  "new_broker_num" : 5
}

  • Increasing the broker flavor (pay-per-use)

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

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

Example Responses

Status code: 200

Instance specifications are modified successfully.

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

Status Codes

Status Code

Description

200

Instance specifications are modified successfully.

Error Codes

See Error Codes.

Parent Topic: Specification Modification Management