Modifying Cluster Kafka Instance Specifications
After creating a Kafka instance, you can increase or decrease its specifications. Table 1 lists available modification options. Only one object can be modified per operation: broker quantity, storage space, or broker flavor.
Modified Object |
Increase |
Decrease |
---|---|---|
Broker quantity |
√ |
× |
Storage space |
√ |
× |
Broker flavor |
√ |
√ |
Notes and Constraints
- Unavailable for single-node instances.
- After instance specifications are changed, the configuration fee changes accordingly.
Impact of Specification Modification
Modified Object |
Impact |
---|---|
Broker quantity |
|
Storage space |
|
Broker flavor |
|
Process of Increasing or Decreasing Broker Flavors
When you scale up or down the broker flavor, a rolling restart is performed on brokers. The following process takes three brokers as an example:
- The Kafka process on Broker 0 is stopped.
- The flavor of Broker 0 is scaled up or down.
- The Kafka process on Broker 0 is restarted.
- 1 to 3 are repeated to scale up or down the flavor of Broker 1.
- 1 to 3 are repeated to scale up or down the flavor of Broker 2.

Modifying the Broker Quantity
- Log in to the Kafka console.
- Click
in the upper left corner to select the region where your instance is located.
- In the row containing the desired instance, choose More > Modify Specifications in the Operation column.
- Specify the required number of brokers.
- For Change By, select Brokers.
- For Brokers, specify the broker quantity. The broker quantity varies by instance flavor. For details, see Cluster Kafka instance specifications.
- If public access has been enabled, configure EIPs for the new brokers.
- For Subnet, retain the default settings.
- For Private IP Addresses, select Auto or Manual.
- Auto: The system assigns an IP address from the subnet automatically.
- Manual: Select the IP addresses for the new brokers from the drop-down list. If the number of selected IP addresses is less than the number of brokers, the remaining IP addresses will be automatically assigned.
- Click Next.
- Confirm the configurations and click Submit.
- Check the modification progress and estimated remaining time.
- In the instance list, click the instance to go to the instance details page.
- In the navigation pane, choose Background Tasks. The Current Tasks tab page is displayed.
- Click the Modify Specifications task. The Specification Modification Task Details dialog box is displayed.
- Check the progress and estimated remaining time. In Steps, check the steps, start time, and end time.
- Check whether the modification is successful.
- If the task is in the Successful state, the modification is successful. View the number of brokers in the Flavor column in the instance list.
- If the task is in the Failed state, the modification is not successful. Move the cursor over Failed or check the cause in Steps.
After the modification fails, the instance is in the Change failed state, and cannot be restarted, modified, or deleted. After the instance status automatically changes from Change failed to Running, you can continue to perform operations. If the status does not change to Running, contact customer service.
- After adding brokers, add the IP addresses of the new brokers to the client connection configuration to improve reliability.
Expanding the Storage Space
- Log in to the Kafka console.
- Click
in the upper left corner to select the region where your instance is located.
- In the row containing the desired instance, choose More > Modify Specifications in the Operation column.
- Specify the required storage space.
- For Change By, select Storage.
- For Storage space per broker, specify a new storage space, and click Next. The storage space range varies by instance specifications. For details, see Cluster Kafka instance specifications.
- Confirm the configurations and click Submit.
- Check the modification progress and estimated remaining time.
- In the instance list, click the instance to go to the instance details page.
- In the navigation pane, choose Background Tasks. The Current Tasks tab page is displayed.
- Click the Modify Specifications task. The Specification Modification Task Details dialog box is displayed.
- Check the progress and estimated remaining time. In Steps, check the steps, start time, and end time.
- Check whether the modification is successful.
- If the task is in the Successful state, the modification is successful. View the new storage space (Storage space per broker × Number of brokers) in the Used/Available Storage Space (GB) column in the instance list.
- If the task is in the Failed state, the modification is not successful. Move the cursor over Failed to view failure causes.
After the modification fails, the instance is in the Change failed state, and cannot be restarted, modified, or deleted. After the instance status automatically changes from Change failed to Running, you can continue to perform operations. If the status does not change to Running, contact customer service.
Increasing or Decreasing the Broker Flavor
- Log in to the Kafka console.
- Click
in the upper left corner to select the region where your instance is located.
- In the row containing the desired instance, choose More > Modify Specifications in the Operation column.
- Specify the required broker flavor.
- For Change By, select Broker Flavor.
- Specify a new broker flavor.
- In the Risk Check area, check for risks.
If any risk is found, handle it as prompted and then click Recheck. If the risks do not need to be handled, select I understand the risks.
- Click Next, confirm the information, and click Submit.
- Check the scaling progress and estimated remaining time.
- In the instance list, click the instance to go to the instance details page.
- In the navigation pane, choose Background Tasks. The Current Tasks tab page is displayed.
- Click the Modify Specifications task. The Specification Modification Task Details dialog box is displayed.
- Check the progress and estimated remaining time. In Steps, check the steps, start time, and end time.
- Check whether the modification is successful.
- If the task is in the Successful state, the modification is successful. View the broker flavor in the Flavor column in the instance list.
- If the task is in the Failed state, the modification is not successful. Move the cursor over Failed to view failure causes.
After the modification fails, the instance is in the Change failed state, and cannot be restarted, modified, or deleted. After the instance status automatically changes from Change failed to Running, you can continue to perform operations. If the status does not change to Running, contact customer service.
Related Document
To change the specifications of a cluster Kafka instance by calling an API, see Increasing Instance Specifications.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.