In ApsaraMQ for RocketMQ, an instance is a virtual machine that is used to store topics and groups. Create an instance before you send or receive messages, then manage its lifecycle through the ApsaraMQ for RocketMQ console.
Instance editions
ApsaraMQ for RocketMQ offers two instance editions:
| Edition | Billing method |
|---|---|
| Standard Edition | Pay-as-you-go |
| Enterprise Platinum Edition | Subscription |
For detailed specifications and pricing, see Instance editions and Billing overview.
Enterprise Platinum Edition instances support the Post-expiration Action parameter, which controls how resources are handled after the instance is unsubscribed or expires. For details, see Lifecycle management.
Create an instance
Create a Standard Edition 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 Instance Version to V4.0.
Set Instance Type to Standard Edition Instance, configure the Name and Description parameters, and then in the lower-left corner of the panel, click OK.
Create an Enterprise Platinum Edition 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 Instance Version to V4.0.
Set Instance Type to Enterprise Platinum Edition, and then in the lower-left corner, click OK.
On the buy page, configure the instance parameters, read and accept the terms of service, and then click Buy Now to complete the payment.
View instance details
Go to the Instances page in the ApsaraMQ for RocketMQ console.
Click an instance name to open its Instance Details page.
Update the instance name or description
Go to the Instances page in the ApsaraMQ for RocketMQ console.
Click the name of the instance that you want to update.
In the Basic Information section of the Instance Details page, click Edit next to the Instance Name or Instance Description field, enter a new value, and then click OK.
Delete an instance
Deleting an instance is irreversible. If the instance is bound to ApsaraMQ for MQTT, the MQTT service becomes unavailable after deletion. Delete all topics and groups on a Standard Edition instance before you delete the instance.
The deletion method depends on the instance edition.
Delete a Standard Edition instance
Standard Edition instances use the pay-as-you-go billing method and can be deleted directly in the console.
Go to the Instances page in the ApsaraMQ for RocketMQ console.
Find the instance that you want to delete, click More in the Actions column, and then select Delete.
In the confirmation dialog box, click OK.
The deleted instance no longer appears on the Instances page.
Unsubscribe from an Enterprise Platinum Edition instance
Enterprise Platinum Edition instances use the subscription billing method and cannot be deleted directly. To remove an Enterprise Platinum Edition instance, unsubscribe from it.
For instructions, see Unsubscribe from an instance.
After you create an instance
After you create an instance, create topics and groups to start sending and receiving messages:
Related API operations
| API | Description |
|---|---|
| OnsInstanceCreate | Creates an instance. |
| OnsInstanceDelete | Deletes an instance. |
| OnsInstanceUpdate | Updates instance information. |