All Products
Search
Document Center

ApsaraMQ for RocketMQ:Manage instances

Last Updated:Feb 28, 2024

In ApsaraMQ for RocketMQ, an instance is a virtual machine that is used to store topics and groups. Before you use ApsaraMQ for RocketMQ to send and receive messages, you must create an ApsaraMQ for RocketMQ instance. This topic describes how to create and delete an instance in the ApsaraMQ for RocketMQ console. This topic also describes how to view the details of an instance and update the information about an instance in the console.

Background information

ApsaraMQ for RocketMQ provides instances of the Standard Edition and Enterprise Platinum Edition. You can select an instance edition based on your business requirements. For information about the specifications and billing methods of Standard Edition and Enterprise Platinum Edition instances, see Instance editions and Billing overview.

Enterprise Platinum Edition instances allow you to change the value of the Post-expiration Action parameter of an instance to specify how to process resources on the instance after the instance is unsubscribed or expired. For more information, see Lifecycle management.

Create an instance

  1. Log on to the ApsaraMQ for RocketMQ console. In the left-side navigation pane, click Instances.

  2. In the top navigation bar, select a region, such as China (Hangzhou).

  3. In the upper-left corner of the Instances page, click Create Instance.

  4. In the Create Message Queue for Apache RocketMQ Instance panel, set the Instance Version parameter to V4.0 and select an instance edition based on your business requirements.

    • Create a Standard Edition instance: Set the Instance Type parameter to Standard Edition Instance and configure the Name and Description parameters. Then, in the lower-left corner of the panel, click OK.

    • Create an Enterprise Platinum Edition instance:

      1. Set the Instance Type parameter to Enterprise Platinum Edition. Then, in the lower-left corner, click OK.

      2. On the instance buy page, follow the on-screen instructions to configure the parameters, read and accept the terms of service, and then click Buy Now to complete the payment.

View the details of an instance

  1. Go to the Instances page in the ApsaraMQ for RocketMQ console.

  2. Find the instance whose details you want to view and click the name of the instance to go to the Instance Details page.

Delete an instance

Warning
  • After you delete an ApsaraMQ for RocketMQ instance, the instance cannot be restored, and ApsaraMQ for MQTT becomes unavailable if the instance is bound to ApsaraMQ for MQTT. Exercise caution when you delete an instance.

  • You must delete all topics and groups on a Standard Edition instance before you can delete the instance.

Delete a Standard Edition instance

Standard Edition instances are billed based on the pay-as-you-go billing method. If you no longer require a Standard Edition instance, you can delete the instance in the ApsaraMQ for RocketMQ console.

  1. Go to the Instances page in the ApsaraMQ for RocketMQ console.

  2. Find the instance that you want to delete and click More in the Actions column. Then, select Delete from the drop-down list.

  3. In the message that appears, click OK.

    On the Instances page, you can no longer view the deleted instance.

Unsubscribe from an Enterprise Platinum Edition instance

Enterprise Platinum Edition instances are billed based on the subscription billing method and cannot be deleted. If you no longer require an Enterprise Platinum Edition instance, you can unsubscribe from the instance.

For more information, see Unsubscribe from an instance.

Update the information about an instance

  1. Go to the Instances page in the ApsaraMQ for RocketMQ console.

  2. Find the instance whose information you want to update and click the name of the instance.

  3. In the Basic Information section of the Instance Details page, click Edit next to the Instance Name and Instance Description fields, enter a new name and description for the instance in the corresponding fields, and then click OK.

References

After you create an instance, you can create topics and groups that are used to send and receive messages on the instance.

You can also call the following API operations to manage instances: