Help Center/ Distributed Message Service for RocketMQ/ User Guide/ Changing Instance Specifications/ Modifying RocketMQ Specifications
Updated on 2026-04-30 GMT+08:00
View PDF

Modifying RocketMQ Specifications

After creating a RocketMQ instance, you can modify its specifications. Table 1 lists available modification options. Only one object can be modified at a time.

Table 1 Specification modification options

Instance Version

Modified Object

Increase

Decrease

4.8.0

Broker quantity

√

×

Storage space

√

×

Broker flavor

√

×

5.x

Storage space (single-node)

√

×

Instance flavor (single-node)

×

×

Storage space (cluster)

√

×

Instance flavor (cluster)

√

√ (Only some flavors can be decreased. See the console.)

Notes and Constraints

  • rocketmq.4u8g.cluster.small does not support broker flavor increase.
  • Configuration fees will change after instance specifications are changed. See the console.

Impact

Table 2 Impact

Instance Version

Modified Object

Impact

4.8.0, 5.x

Storage

Storage space expansion does not affect services.

4.8.0

Brokers

Adding brokers does not affect the original brokers or services.

4.8.0

Broker Flavor

Increasing the broker flavor will interrupt the instance for about one minute. If the production TPS is high during the change, the change may fail. To prevent this from happening, add brokers first.

5.x

Flavor

Increasing an instance flavor does not affect services.

Prerequisites

  • The RocketMQ instance is in the Running state.
  • The user to modify instance specifications must have the DMS FullAccess permission.

Procedure

The following describes how to modify the specifications of a RocketMQ instance.

  1. Log in to the RocketMQ console.
  2. Modify the instance specifications in either of the following ways:

    • Locate the row containing the desired instance, click Modify Specifications.
    • Click a RocketMQ instance name to go to the instance overview page. Click Modify Specifications in the upper right corner.

  3. Select Storage for Change By and enter a storage size.
  4. Click Next.
  5. Confirm the capacity expansion information. If the billing mode is yearly/monthly, click Pay Now and complete the payment as prompted. If the billing mode is pay-per-use, click Submit.
  6. The instance is in the Changing state on the RocketMQ instance list page.

    When the instance is in the Running state, the expanded available storage space can be viewed in Used/Available Storage Space.

    Available storage space = Actual storage space – Storage space for storing logs – Disk formatting loss

    For example, if the storage space is expanded to 700 GB, the storage space for storing logs is 100 GB, and the disk formatting loss is 7 GB, then the available storage space after capacity expansion will be 593 GB.

This operation is available only for v4.8.0 instances.

Before increasing the broker quantity, view security group details in Overview > Network > Security Group. Check whether the allowed network segment and port meet the following requirements:

  • Allowed network segment: network segment of the instance's subnet.
  • Port range: 10100–(10100 + 3 × n – 1). n is the number of brokers.

If the configuration is incorrect, a client may fail to connect to the new service node. As a result, message production fails.

  1. Log in to the RocketMQ console.
  2. Modify the instance specifications in either of the following ways:

    • Locate the row containing the desired instance, click Modify Specifications.
    • Click a RocketMQ instance name to go to the instance overview page. Click Modify Specifications in the upper right corner.

  3. Select Brokers for Change By and enter the number of brokers.
  4. Click Next.
  5. Confirm the capacity expansion information. If the billing mode is yearly/monthly, click Pay Now and complete the payment as prompted. If the billing mode is pay-per-use, click Submit.
  6. The instance is in the Changing state on the RocketMQ instance list page.

    When the instance is in the Running state, view the expansion result in either of the following ways:

    • In Flavor, view the new number of brokers.
    • In Used/Available Storage Space, the total storage space is recalculated (New broker quantity × Storage space per broker) and displayed.

      The system performs the expansion by proportion according to the current disk configuration. For example, assume that the original number of brokers of an instance is 1 and the disk size of each broker is 300 GB. If the broker quantity changes to 2 and the disk size per broker is still 300 GB, the total disk size becomes 600 GB.

This operation is available only for v4.8.0 instances.

  1. Log in to the RocketMQ console.
  2. Modify the instance specifications in either of the following ways:

    • Locate the row containing the desired instance, click Modify Specifications.
    • Click a RocketMQ instance name to go to the instance overview page. Click Modify Specifications in the upper right corner.

  3. Select Broker Flavor for Change By and select a new broker flavor.

    If there are risks found in the Risk Check area, handle them as prompted and click Recheck until all check items are normal. Otherwise, the expansion may fail.

  4. Click Next.
  5. Confirm the capacity expansion information. If the billing mode is yearly/monthly, click Pay Now and complete the payment as prompted. If the billing mode is pay-per-use, click Submit.
  6. The instance is in the Changing state on the RocketMQ instance list page.

    When the instance is in the Running state, view the new broker flavor in Flavor.

This operation is involved only for v5.x.

Before scaling the instance, ensure that the subnet segments are allowed in the security group.

  1. Log in to the RocketMQ console.
  2. Modify the instance specifications in either of the following ways:

    • Locate the row containing the desired instance, click Modify Specifications.
    • Click a RocketMQ instance name to go to the instance overview page. Click Modify Specifications in the upper right corner.

  3. Select Flavor for Change By and select a new instance flavor.
  4. Click Next.
  5. Confirm the capacity expansion information. If the billing mode is yearly/monthly, click Pay Now and complete the payment as prompted. If the billing mode is pay-per-use, click Submit.
  6. The instance is in the Changing state on the RocketMQ instance list page.

    When the instance is in the Running state, view the new instance flavor in Flavor.

Parent Topic: Changing Instance Specifications