In ApsaraMQ for RabbitMQ, an instance is an independent entity that includes basic resources such as virtual hosts (vhosts), exchanges, and queues. An instance can be considered as an isolated server or service environment in which messages are received, stored, and delivered. This topic describes how to create an instance, view instance details, upgrade and downgrade instance configurations, and renew an instance in the ApsaraMQ for RabbitMQ console.
Instance status
The status of ApsaraMQ for RabbitMQ instances varies based on the billing method and instance edition.
Table 1. Status
Status | Description |
Deploying |
|
Running |
|
Stopped |
|
Released |
|
Supported operations
Operation | Description |
ApsaraMQ for RabbitMQ provides Professional Edition, Enterprise Edition, Enterprise Platinum Edition, and Serverless Edition instances. For information about the differences among the instance editions, see Instance editions. Note ApsaraMQ for RabbitMQ Serverless Edition instances are available only in the following regions: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Shenzhen), China (Guangzhou), China (Chengdu), China (Hong Kong), Singapore, Philippines (Manila), Indonesia (Jakarta), and Thailand (Bangkok). If you want to purchase ApsaraMQ for RabbitMQ Serverless Edition instances in a region other than the preceding regions, submit a ticket to contact ApsaraMQ for RabbitMQ technical support. | |
You can view the basic information, endpoints, and usage limits of an instance in the ApsaraMQ for RabbitMQ console. You can also query messages and the peak transactions per second (TPS) of an instance in the ApsaraMQ for RabbitMQ console. Note You can view the peak TPS of an instance only if the message trace feature is enabled for the instance. | |
You can upgrade or downgrade the following configuration items of ApsaraMQ for RabbitMQ Professional Edition, Enterprise Edition, and Enterprise Platinum Edition instances:
You can upgrade or downgrade the following configuration items of ApsaraMQ for RabbitMQ Serverless Edition instances:
| |
If an instance is released due to overdue payments, the service becomes unavailable and your business is interrupted. To prevent the issue, renew the instance at the earliest opportunity. Note
| |
Note The elastic TPS feature is supported only by ApsaraMQ for RabbitMQ Professional Edition, Enterprise Platinum Edition, and Enterprise Edition instances. Elastic TPS is the TPS that exceeds the specification limit of an instance. If your actual TPS usage may exceed the specification limit of your instance due to bursty traffic, you can enable the elastic TPS feature to increase the peak TPS of your instance within a specific range. This prevents business interruption that is caused by instance throttling. You are charged for elastic TPS. For information about the upper limits and billing rules of elastic TPS, see Billing of elastic TPS. |
Create an instance
Log on to the ApsaraMQ for RabbitMQ console. In the left-side navigation pane, click Instances.
In the top navigation bar, select a region. On the Instances page, click Create Instance.
On the buy page, follow the on-screen instructions to complete the configurations, read and select the terms of service, and then click Buy Now.
Follow the on-screen instructions to complete the payment.
In the top navigation bar of the Instances page, select the region where the instance was created. On the page that appears, view the instance that you created.
NoteAfter you purchase a Professional Edition or Enterprise Edition instance, the instance immediately enters the Running state.
After you purchase an Enterprise Platinum Edition instance, the instance enters the Deploying state. After the instance is deployed, the instance enters the Running state.
View instance details
Log on to the ApsaraMQ for RabbitMQ console. In the left-side navigation pane, click Instances.
In the top navigation bar of the Instances page, select the region where the instance that you want to manage resides. Then, in the instance list, click the name of the instance that you want to manage.
On the Instance Details page, view the details of the instance.
Upgrade or downgrade instance configurations
Usage notes
You can upgrade or downgrade only the configurations of instances that are in the Running state.
In ApsaraMQ for RabbitMQ, Professional Edition and Enterprise Edition instances are of the shared cluster type, and Enterprise Platinum Edition instances are of the dedicated cluster type. When you upgrade a Professional Edition or Enterprise Edition instance to an Enterprise Platinum Edition instance, the instance is migrated between clusters. The migration requires 30 to 60 minutes to complete. The migration duration varies based on the number of queues and the migrated data volume.
When you upgrade a Professional Edition or Enterprise Edition instance to an Enterprise Platinum Edition instance, the endpoint of the instance is not changed and client connections are not forcibly closed. However, the metadata of the instance is migrated. To shorten the upgrade time in the backend, we recommend that you upgrade instance configurations during off-peak hours.
If an instance upgrade or downgrade is not completed after a long period of time and a message that indicates data is being migrated is displayed for specific operations, the data in a specific queue may not be fully consumed. In this case, you can reduce the number of produced messages in the queue or increase the number of consumers.
If you downgrade an Enterprise Platinum Edition instance to a Professional Edition or Enterprise Edition instance, instance data is not migrated and your business is not affected.
You cannot upgrade an instance from Serverless Edition to another edition.
Procedure
Log on to the ApsaraMQ for RabbitMQ console. In the left-side navigation pane, click Instances.
In the top navigation bar of the Instances page, select the region where the instance that you want to manage resides. Then, in the instance list, click the name of the instance that you want to manage.
On the Instance Details page, click Upgrade or Downgrade in the upper-right corner of the Overview section.
In the panel that appears, follow the on-screen instructions to configure the parameters, read and select the terms of service, and then click Buy Now.
Follow the on-screen instructions to complete the payment.
Renew an instance
Only Enterprise Edition, Professional Edition, and Enterprise Platinum Edition instances require renewal.
The resources and data of an expired instance are retained and can be restored after you renew the instance.
The resources and data of a released or deleted instance are not retained and cannot be restored.
Log on to the ApsaraMQ for RabbitMQ console. In the left-side navigation pane, click Instances.
In the top navigation bar of the Instances page, select the region where the instance that you want to manage resides. Then, in the instance list, click the name of the instance that you want to manage.
On the Instance Details page, click Renew in the upper-right corner of the Overview section.
In the Renew panel that appears, specify the subscription duration, read and select the terms of service, and then click Buy Now.
Follow the on-screen instructions to complete the payment.
NoteIf you do not renew an instance at your earliest opportunity, the payment for the instance becomes overdue and the instance expires and becomes unavailable. We recommend that you enable auto-renewal when you create an instance.
In the Basic Information section of the Instance Details page, you can view the Expired At parameter to check the expiration time of the instance after renewal.
Enable the elastic TPS feature for an instance
If your Alibaba Cloud account has overdue payments, you cannot enable the elastic TPS feature for an instance.
The elastic TPS feature is supported only by ApsaraMQ for RabbitMQ Professional Edition, Enterprise Platinum Edition, and Enterprise Edition instances.
Log on to the ApsaraMQ for RabbitMQ console. In the left-side navigation pane, click Instances.
In the top navigation bar of the Instances page, select the region where the instance that you want to manage resides. Then, in the instance list, click the name of the instance that you want to manage.
In the Overview section of the Instance Details page, turn on the Enable Elasticity Quota switch in the Maximum TPS card.
In the message that appears, click OK.