This topic describes how to create, delete, update, and query instances in the Message Queue for Apache RocketMQ console.

Background information

An instance is a virtual machine (VM) resource of Message Queue for Apache RocketMQ. An instance stores topics and group IDs.

Message Queue for Apache RocketMQ provides instances of the Standard Edition and the Enterprise Platinum Edition, which provide different specifications. You can choose the Standard Edition or the Enterprise Platinum Edition based on your business needs. For more information about the specifications and billing methods of Standard Edition instances and Enterprise Edition instances, see Instance editions and Billing overview.

You can change the action for processing resources by configuring Configure Post-release Action after your Enterprise Platinum Edition instance is refunded or released. For more information, see Change the post-release action for an instance.

Usage notes

When you use an instance, take note of the following points:
  • Enterprise Platinum Edition instances cannot be manually released. You can delete an Enterprise Platinum Edition instance only after it expires.
  • You must delete all the topics and groups in a Standard Edition instance before you can delete the instance.

Create an instance

  1. Log on to the Message Queue for Apache RocketMQ console.
  2. In the left-side navigation pane, click Instances.
  3. In the top navigation bar, select a region, such as China (Hangzhou).
  4. On the Instances page, click Create Instance in the upper-left corner.
  5. In the Create Message Queue for Apache RocketMQ Instance panel, select an instance type.
    • Create a Standard Edition instance: Select Standard Edition Instance for Instance Type. Set Name and Description parameters. Then, click OK in the lower-left corner of the panel. Create a Standard Edition instance
    • Create an Enterprise Platinum Edition instance:
      1. Select Enterprise Platinum Edition Instance for Instance Type. Then, click OK in the lower-left corner of the panel. Create an Enterprise Platinum Edition instance
      2. On the Message Queue for Apache RocketMQ Enterprise Platinum Edition page, configure the instance specifications and click Buy Now in the lower-right corner.
      3. On the Confirm Order page, select I have read and agree to Message Queue for Apache RocketMQ Enterprise Platinum Edition Terms of Service and click Pay.
      4. On the Purchase page, click Purchase.
    On the Instances page, you can view the instance that you created.

Delete an instance

Notice After you delete an instance, it cannot be restored and the Message Queue for MQTT service bound to this instance becomes unavailable. Exercise caution when you perform this operation.
  1. Log on to the Message Queue for Apache RocketMQ console.
  2. In the left-side navigation pane, click Instances.
  3. In the top navigation bar, select a region, such as China (Hangzhou).
  4. On the Instances page, find the instance that you want to delete, click More in the Actions column, and then select Delete.
  5. In the message that appears, click OK.
    On the Instances page, you can no longer view the instance that you deleted.

Update an instance

  1. Log on to the Message Queue for Apache RocketMQ console.
  2. In the left-side navigation pane, click Instances.
  3. In the top navigation bar, select a region, such as China (Hangzhou).
  4. On the Instances page, find the instance that you want to update, and click the instance name or click Details in the Actions column. The Instance Details page appears.
  5. In the Basic Information section, click Edit next to Instance Name or Instance Description. Modify the name or description of the instance in the field and click OK. Update an instance
    On the Instances page, you can view the new name or description of the instance.

Query an instance

  1. Log on to the Message Queue for Apache RocketMQ console.
  2. In the left-side navigation pane, click Instances.
  3. In the top navigation bar, select a region, such as China (Hangzhou).
  4. On the Instances page, find the instance that you want to view, and click the instance name or click Details in the Actions column. The Instance Details page appears.
    On the Instance Details page, you can view the details of the instance.

More operations

On the Instances page, you can perform other related operations.

On the Instances page, find the instance that you want to manage, click More in the Actions column, and then select one of the following options:
  • Topics: allows you to manage topics in the instance. For more information, see Manage topics.
  • Groups: allows you to manage groups in the instance. For more information, see Manage groups.
  • Message Query: allows you to query the messages in the topics of the instance. For more information, see Query messages.
  • Message Trace: allows you to query the traces of the messages in the topics of the instance by creating query tasks. For more information, see Query a message trace.
  • Dead-letter Queues: allows you to query and resend dead-letter messages in the instance. For more information, see Dead-letter queues.
  • Resource Statistics: allows you to view the statistics on message production of topics in the instance and the statistics on message consumption of groups in the instance. For more information, see Resource reports.
  • Monitoring and Alerting: allows you to view the alert rules for the instance. For more information, see Monitoring and alerting.
  • Renew, Upgrade, and Downgrade: allow you to change the specifications of the instance. This feature is available only to Enterprise Platinum Edition instances. For more information, see Operations on Enterprise Platinum Edition instances.
  • Upgrade to Enterprise Edition: allows you to upgrade the instance from the Standard Edition to the Enterprise Platinum Edition. For more information, see Change the billing method from pay-as-you-go to subscription.

References

You can call the following API operations to manage instances: