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
Log on to the ApsaraMQ for RocketMQ console. In the left-side navigation pane, click Instances.
In the top navigation bar, select a region, such as China (Hangzhou).
In the upper-left corner of the Instances page, click Create Instance.
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:
Set the Instance Type parameter to Enterprise Platinum Edition. Then, in the lower-left corner, click OK.
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
Go to the Instances page in the ApsaraMQ for RocketMQ console.
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
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.
Go to the Instances page in the ApsaraMQ for RocketMQ console.
Find the instance that you want to delete and click More in the Actions column. Then, select Delete from the drop-down list.
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
Go to the Instances page in the ApsaraMQ for RocketMQ console.
Find the instance whose information you want to update and click the name of the instance.
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.
For information about how to create a topic, see Manage topics.
For information about how to create a group, see Manage groups.
You can also call the following API operations to manage instances:
OnsInstanceCreate: creates an instance.
OnsInstanceDelete: deletes an instance.
OnsInstanceUpdate: updates the information about an instance.