This topic describes how to create, update, and delete an instance, and view the details of an instance in the Message Queue for MQTT console.

Background information

An instance is a VM of Message Queue for MQTT. An instance stores topics and group IDs.

Message Queue for MQTT provides two types of instances based on the billing method: subscription instances and pay-as-you-go instances. Subscription instances are divided into instances of Enterprise Platinum Edition, Basic Edition, and Lite Edition. For more information about the differences in specifications and the billing information of different instance types, see Instance types and Billing.

Limits

For more information, see Limits.

Create an instance

  1. On the Instances page, click Create Instance in the upper-left corner.
  2. In the panel that appears, select a billing method as needed.
    Message Queue for MQTT supports the Pay-as-you-go and Subscription billing methods. For more information about the two billing methods, see Billing.
    • Create a pay-as-you-go instance:
      1. Set Billing Method to Pay-as-you-go and click OK.
      2. In the panel that appears, set the parameters as needed and click Buy Now.
    • Create a subscription instance:
      1. Set Billing Method to Subscription and click OK.
      2. In the panel that appears, set the parameters as needed and click Buy Now.
      3. In the panel that appears, click Purchase.
    After you complete the purchase, refresh the Instances page in the Message Queue for MQTT console. The instance that you created appears in the instance list.

Update an instance

  1. Log on to the Message Queue for MQTT console.
  2. In the left-side navigation pane, click Instances.
  3. In the top navigation bar, select the region where your instance is located.
  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.
  5. In the Basic Information section of the Instance Details page, click the Edit icon next to Name or Description. Modify the name or description of the instance in the field and click OK.
    Update an instance

View the details of an instance

After an instance is created, you can go to the Instance Details page to view the details of the instance, including the basic information of the instance, the statistics about the messages that are sent and received for the instance, and the endpoints of the instance.
  1. Log on to the Message Queue for MQTT console.
  2. In the left-side navigation pane, click Instances.
  3. In the top navigation bar, select the region where your instance is located.
  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.
    • View the basic information
      In the Overview and Basic Information sections of the Instance Details page, you can view the basic information of the instance, such as the instance type, instance ID, instance status, and billing method. Basic instance information
    • View instance statistics
      On the Instance Details page, click the Statistics tab. Set a time range to query the statistics about the messages that are sent and received for the instance within the specified time range. The statistics include the messaging transactions per second (TPS), the number of subscription relationships, and the number of connected clients. Instance statistics
    • Obtain an endpoint
      On the Instance Details page, click the Endpoints tab. In the endpoint list, you can view the public endpoint and virtual private cloud (VPC) endpoint that are provided by Message Queue for MQTT. For more information about the endpoints, see Endpoints. Endpoints

Delete an instance

Notice
  • After an instance is deleted, its data cannot be recovered. Exercise caution when you delete an instance.
  • You cannot manually release a subscription instance. You can delete the instance only after it expires.
  • Before you delete an instance, you must clear all topics and groups in the instance.
  1. Log on to the Message Queue for MQTT console.
  2. In the left-side navigation pane, click Instances.
  3. In the top navigation bar, select the region where your instance is located.
  4. On the Instances page, find the instance that you want to delete and choose More > Delete in the Actions column.
  5. In the Note message, click OK.

What to do next

  • Change the billing method of an instance from subscription to pay-as-you-go

    After you create a Message Queue for MQTT subscription instance, you can change its billing method from subscription to pay-as-you-go. After the change, you can recoup part of your cost and use the Message Queue for MQTT instance on demand.

  • Renew an instance and upgrade or downgrade the configuration of an instance

    If you need to use an instance for a long time, you can enable the auto-renewal feature for the instance. This avoids the business impact caused by the failure to renew the instance in time when the instance expires. During the use of the instance, you can also flexibly upgrade or downgrade the configuration of the instance based on the actual business traffic.