An instance is an independent Message Queue for RabbitMQ resource entity that includes basic resource elements such as virtual hosts (vhosts), exchanges, and queues. This topic describes how to create an instance, view instance details, upgrade instance configurations, downgrade instance configurations, and renew instances in the Message Queue for RabbitMQ console.

Status

The status of a Message Queue for RabbitMQ instance varies based on the billing method of the instance and the instance edition.

Table 1. Status
Instance status Description
Deploying
  • An instance in this state is unavailable.
  • This state is supported only for instances of the Platinum Edition. This is because an instance of the Platinum Edition must be deployed by technical support after the instance is purchased.
Running
  • An instance in this state is available.
  • After an instance of the Professional Edition or Enterprise Edition is purchased, the instance enters the Running state.
Stopped
  • An instance in this state is unavailable.
  • The resources and data of an instance that is in this state are retained and can be recovered.
Released
  • An instance in this state is unavailable.
  • The resources of an instance in this state are released and the data of the instance is deleted. The resources and data cannot be recovered.
Note You cannot manually release an instance. After an instance expires, the instance is automatically released. You can delete the record of the expired instance in the console. After the instance is deleted, the resources of the instance are released and the data of the instance is deleted. The resources and data cannot be recovered.

Supported operations

Supported operation Description
Create an instance Message Queue for RabbitMQ provides the following editions: Professional Edition, Enterprise Edition, and Platinum Edition. The availability, features, and limits of the editions are different. For more information about the differences among the editions, see Instance editions.
  • Professional Edition: shared instances in which tenants are logically isolated and data is persistent. Each instance has three replicas to ensure high availability.
  • Enterprise Edition: shared instances in which tenants are logically isolated and data is persistent. Each instance has three replicas to ensure high availability.
  • Platinum Edition: dedicated instances in which data is persistent. Each instance has three replicas to ensure high availability. A dedicated instance is deployed in a dedicated physical cluster.
Note Message Queue for RabbitMQ instances of the Basic Edition are deprecated. You can continue to use the existing instances of the Basic Edition.
View instance details You can view the basic information about an instance and the access points, limits, and queried messages of the instance in the Message Queue for RabbitMQ console.
Upgrade instance configurations When the workloads on your business increase, you can increase the peak transactions per second (TPS) and the maximum number of queues for your instance. This helps prevent your business from being interrupted due to insufficient resources.
You can upgrade the following configuration items:
  • Instance Type. You can select an edition that has higher specifications only if you use instances of the Professional Edition and Enterprise Edition.
    Note You can upgrade instances of the Professional Edition and Enterprise Edition to instances of the Platinum Edition.
  • EIP Support
  • Internet TPS
  • Peak TPS
  • Queues
    Notice After you increase the threshold values of an instance of the Professional Edition or Enterprise Edition, the actual threshold values vary based on the value of the Queues parameter of the instance. If you increase the value of the Queues parameter, the threshold values of the instance are increased. For more information, see Limits on clusters.
  • Maximum Number of Connections. You can increase the value of this parameter only if you use instances of the Enterprise Edition and Platinum Edition.
  • Message Storage Space. You can increase the value of this parameter only if you use instances of the Platinum Edition.
Downgrade instance configurations When your business loads decrease, you can decrease the peak TPS and the maximum number of queues for your instance. This helps improve resource utilization and reduce costs.
You can downgrade the following configuration items:
  • EIP Support
  • Internet TPS
  • Peak TPS
  • Queues
    Notice After you decrease the threshold values of an instance of the Professional Edition or Enterprise Edition, the actual threshold values vary based on the value of the Queues parameter of the instance. If you decrease the value of the Queues parameter, the threshold values of the instance are decreased. For more information, see Limits on clusters.
  • Maximum Number of Connections. You can increase the value of this parameter only if you use instances of the Enterprise Edition and Platinum Edition.
  • Message Storage Space. You can increase the value of this parameter only if you use instances of the Platinum Edition.
Renew an instance If an instance is released due to overdue payments, the service becomes unavailable and your business is affected. To prevent this issue, you must renew the instance at the earliest opportunity.
Note
  • The subscription billing method is used for the instance and the instance is in the Expired state or the Running state.
  • The renewal operation applies only to subscription instances. For existing pay-as-you-go instances, you need only to keep the account balance sufficient. Message Queue for RabbitMQ no longer supports new pay-as-you-go instances.
  • For more information about instance expiration, see Overview.

Create an instance

  1. Log on to the Message Queue for RabbitMQ console.
  2. In the Resource Distribution section of the Overview page, select the region where your instance is located.
  3. On the Instances page, click Create Instance.
  4. Purchase an instance by using one of the following methods:
      1. In the buy panel, select a subscription duration, configure other required parameters, read the subscription agreement, select I have read and agree to Message Queue for RabbitMQ Subscription Agreement of Service, and then click Buy Now.
      2. In the panel that appears, confirm the order information and click Purchase.
      1. Click Go to Buy Page. On the Message Queue for RabbitMQ Subscription page, select a subscription duration, configure other required parameters, and then click Pay.
      2. On the Confirm Order page, read the subscription agreement, select I have read and agree to Message Queue for RabbitMQ Subscription Agreement of Service, and then click Purchase.
      3. On the purchase page, confirm the order information and click Purchase.
    In the top navigation bar, select the region where the instance is deployed. On the Instances page, the created instance appears.
    Note
    • After you purchase an instance of the Professional Edition or Enterprise Edition, the instance enters the Running state.
    • After you purchase an instance of the Platinum Edition, the instance enters the Deploying state. After cluster deployment is complete, the instance enters the Running state.

View instance details

  1. Log on to the Message Queue for RabbitMQ console.
  2. In the Resource Distribution section of the Overview page, select the region where your instance is located.
  3. On the Instances page, click the name of your instance.
  4. On the Instance Details page, view the details of the instance.
    pg_instance_detail
    Table 2. Instance details
    Section Parameter Description
    Overview vhosts The maximum number of vhosts that can be created in the instance.
    Maximum Queues The maximum number of queues that can be created in the instance. For information about how to change the value of this parameter, see Upgrade instance configurations.
    Maximum TPS The peak TPS of the instance. For information about how to change the value of this parameter, see Upgrade instance configurations.
    Basic Information Instance Name The name of the instance. You can manually change the instance name.
    Instance ID The ID of the instance. You cannot change the instance ID.
    Instance Edition Message Queue for RabbitMQ provides instances of the Professional Edition, Enterprise Edition, and Platinum Edition. For more information, see Instance editions.
    Status The status of the instance. For more information, see Running status.
    Billing Method The billing method of the instance. For more information, see Overview.

    On the Renewal Management page, you can renew the instance or enable auto-renewal for the instance before the instance expires.

    Created At The time when the instance is created. The value is accurate to seconds.
    Expired At The time when the instance expires. The value is accurate to seconds.
    Support Internet Access Specifies whether the instance can be accessed over the Internet. For information about how to change the value of this parameter, see Upgrade instance configurations.
    Protocol Version The version of Advanced Message Queuing Protocol (AMQP). The version is 0-9-1.
    Endpoint Information VPC Endpoint The VPC endpoint of the instance.
    Public Endpoint The public endpoint of the instance. Only instances for which EIP Support is enabled can be accessed by using the public endpoint.
    Limits Connections per Instance The maximum number of connections that can be established for each instance.
    vhosts per Instance The maximum number of vhosts that can be created for each instance.
    Exchanges per vhost The maximum number of exchanges that can be created for each vhost.
    Bindings per vhost The maximum number of bindings that can be created for each vhost.
    Consumers per Queue The maximum number of consumers that can be pulled for each queue.
    Channels per Connection The maximum number of channels that can be created for each connection.
    Message Size The maximum number of bytes of a message in a queue.
    Maximum Retention Period of Delayed Messages The maximum period of time for which a delayed message can be retained in a queue.
    Maximum Number of Times Messages Are Requeued The maximum number of times that a message can be requeued.
    Message Query Query Method The method that is used to query messages. For more information, see Query messages.
    • Query by Message ID
    • Query by Queue
    Vhost The name of the vhost for which you want to query messages.
    Queue The name of the queue for which you want to query messages.
    Time Range The time range during which you want to query messages.

Upgrade instance configurations

Notice
  • You can upgrade only the configurations of subscription instances that are in the Running state.
  • You can upgrade only the configurations of subscription instances. You cannot upgrade the configurations of pay-as-you-go instances or instances of the Basic Edition.
  1. Log on to the Message Queue for RabbitMQ console.
  2. In the Resource Distribution section of the Overview page, select the region where your instance is located.
  3. On the Instances page, click the name of your instance.
  4. On the Instance Details page, click Upgrade Configuration in the upper-right corner of the Overview section.
  5. Upgrade the configurations of an instance by using one of the following methods:
      1. In the Upgrade/Downgrade panel, configure the required parameters to upgrade the instance configurations, read the subscription agreement, select I have read and agree to Message Queue for RabbitMQ Subscription Agreement of Service, and then click Buy Now.
      2. In the panel that appears, confirm the order information and click Purchase.
      1. Click Go to Buy Page. On the Upgrade/Downgrade page, configure the EIP Support, Peak TPS, and Queues parameters, read the subscription agreement, select I have read and agree to Message Queue for RabbitMQ Subscription Agreement of Service, and then click Buy Now.
      2. On the purchase page, confirm the order information and click Purchase.
    On the Instances page, click the name of the instance for which you upgraded the configurations. On the Instance Details page, view the upgraded configurations of the instance.

Downgrade instance configurations

Notice
  • You can downgrade only the configurations of subscription instances that are in the Running state.
  • You can downgrade only the configurations of subscription instances. You cannot downgrade the configurations of pay-as-you-go instances or instances of the Basic Edition.
  1. Log on to the Message Queue for RabbitMQ console.
  2. In the Resource Distribution section of the Overview page, select the region where your instance is located.
  3. On the Instances page, click the name of your instance.
  4. On the Instance Details page, click Downgrade in the upper-right corner of the Overview section.
  5. Downgrade the configurations of the instance by using one of the following methods:
      1. In the Downgrade panel, configure the downgrade parameters, read the subscription agreement, select I have read and agree to Message Queue for RabbitMQ Subscription Agreement of Service, and then click Buy Now.
      2. In the panel that appears, confirm the order information and click Purchase.
      1. Click Go to Buy Page. On the Downgrade page, configure the required parameters to downgrade the instance configurations, read the subscription agreement, select I have read and agree to Message Queue for RabbitMQ Subscription Agreement of Service, and then click Buy Now.
      2. On the purchase page, confirm the order information and click Purchase.
    On the Instances page, click the name of the instance for which you downgraded the configurations. On the Instance Details page, view the downgraded configurations of the instance.

Renew an instance

Notice
  • 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.
  1. Log on to the Message Queue for RabbitMQ console.
  2. In the Resource Distribution section of the Overview page, select the region where your instance is located.
  3. On the Instances page, click the name of your instance.
  4. On the Instance Details page, click Renew in the upper-right corner of the Overview section.
  5. In the Renew panel, renew the instance. Renew the instance by using one of the following methods:
      1. Select a subscription duration, read the subscription agreement, select I have read and agree to Message Queue for RabbitMQ Subscription Agreement of Service, and then click Buy Now.
      2. In the Unpaid Orders panel, confirm the order information and click Purchase.
      1. Click Go to Buy Page. On the Renew page, select a subscription duration, read the subscription agreement, select I have read and agree to Message Queue for RabbitMQ Subscription Agreement of Service, and then click Buy Now.
      2. On the Purchase page, confirm the order information and click Purchase.
    Note If you do not renew an instance at the earliest opportunity and the payment for the instance becomes overdue, the instance becomes unavailable after the instance expires. We recommend that you select auto-renewal when you create an instance.
    In the Basic Information section of the Instance Details page, you can view the value of the Expired At parameter of the instance after renewal.