All Products
Search
Document Center

ApsaraMQ for RocketMQ:Lifecycle management for Enterprise Platinum Edition instances

Last Updated:Jul 10, 2026

Create, upgrade, downgrade, renew, or unsubscribe from an Enterprise Platinum Edition instance.

Create an Enterprise Platinum Edition instance

Create a Message Queue for Apache RocketMQ Enterprise Platinum Edition instance in the console.

  1. In the Message Queue for Apache RocketMQ console, go to the Instances page and select a region.

  2. On the Instances page, click Create Instance and complete the purchase.

    • Instance Version: Select V4.0.

    • Instance Type: Select Enterprise Platinum Edition.

    • Product Type: The default value is Subscription.

Upgrade or downgrade an instance

Upgrade or downgrade the specifications of an existing Enterprise Platinum Edition instance.

Impacts of upgrading and downgrading

  • The Message Queue for Apache RocketMQ console and each service node in the instance may experience brief, transient interruptions. Although client-side retry mechanisms typically prevent business impact, you may still see exception logs and message delays.

  • Messages may be duplicated. We recommend implementing message idempotence.

  • Avoid performing management operations, such as creating or deleting topics, in the console during an instance upgrade or downgrade.

  • When you use an HTTP client to connect to the Message Queue for Apache RocketMQ server, transient interruptions or connection rejections may occur. Each interruption or rejection typically lasts for no more than one minute. Implement reconnection logic in your client.

Use CloudMonitor to monitor critical services and track instance status and key metrics during an upgrade or downgrade. For more information, see Configure monitoring alerts for early risk warning.

Rules for upgrading and downgrading

Item

Description

Modifiable configurations

  • peak TPS

  • maximum topics

  • message storage space

Effective period

Changes apply to the current subscription cycle.

Impact on billing

  • Upgrade: You must pay a supplemental fee, calculated by the system, to complete the upgrade.

  • Downgrade: After the downgrade is complete, the system refunds the cost difference to your original payment method.

Procedure

  1. On the Instances page of the Message Queue for Apache RocketMQ console, select the region where your instance is located.

  2. On the Instances page, click the name of the target instance to go to the Instance Details page. In the upper-right corner of the page, click Upgrade or Downgrade and follow the instructions.

Renew an instance

Only Enterprise Platinum Edition instances of Message Queue for Apache RocketMQ support renewal. Enable auto-renewal or renew manually.

Auto-renewal

Enable auto-renewal for long-term services to prevent resource and data loss from missed payments. The system automatically renews resources before they expire.

Auto-renewal rules

  • Auto-renewal attempts typically start nine days before the expiration date and are triggered once per day. The attempts continue until the renewal is successful or until one day before expiration.

  • The auto-renewal process starts at 08:00 (UTC+8) each day. Because instances are renewed sequentially, your instance will be renewed between 08:00 and 18:00 on that day.

  • Example of expiration time calculation: If an instance expires at 00:00:00 on December 11, "one day before expiration" refers to 00:00:00 on December 10, and "six days after expiration" refers to 00:00:00 on December 17.

  • Enabling auto-renewal does not trigger an immediate renewal. The process is triggered only at the scheduled times described above.

  • You must enable auto-renewal before the instance expires. If you enable it after expiration, auto-renewal will not be triggered.

  • Important: Auto-renewal enabled after 08:00 on the day before expiration might not take effect in time. Enable it well in advance to ensure timely renewal.

Procedure

  • Method 1: Configure auto-renewal during purchase

    When you purchase a new instance, select the Auto-renewal Recommended option.

  • Method 2: Configure auto-renewal in the renewal management console

    1. Log on to the Message Queue for Apache RocketMQ console. On the Instance Details page, find and copy the Instance ID from the Basic Information section.

    2. In the top navigation bar, choose Expenses > Subscription Orders > Resource Renewal.

    3. On the Resource Renewal page, click the Manual Renewal tab. Find the instance for which you want to enable auto-renewal, and then click Enable Auto-renewal in the Actions column.

    4. In the Enable Auto-renewal dialog box, select an Auto-renewal Duration and click Enable Auto-renewal.

Manual renewal

If auto-renewal is not enabled, you must manually renew the instance before it expires to continue using the service.

Manual renewal rules

  • Instance limit: You cannot renew an instance that expired more than seven days ago.

  • Renewal duration limit: You can renew an instance for a period of 1 to 9 months, or for 1, 2, or 3 years.

Procedure

  1. On the Instances page of the Message Queue for Apache RocketMQ console, select a region.

  2. On the Instances page, click the name of the target instance to go to the Instance Details page. In the upper-right corner of the page, click Renew and follow the instructions.

Unsubscribe from an Enterprise Platinum instance

Unsubscription rules

  • Message Queue for Apache RocketMQ Enterprise Platinum Edition instances support unsubscription with a partial refund. For more information, see Unsubscription rules.

  • By default, the Post-expiration Action for an Message Queue for Apache RocketMQ Enterprise Platinum Edition instance is set to Delete Resource. This means the instance and its resources are deleted immediately after the instance expires or you unsubscribe.

  • If you change the Post-expiration Action to Downgrade to Standard Edition, the instance is converted to a Standard Edition instance after expiration or unsubscription. It will then be billed on a pay-as-you-go basis. For more information, see Convert an Enterprise Platinum Edition instance to a Standard Edition instance.

  • You can view and modify the Post-expiration Action on the Instance Details page in the ApsaraMQ for RocketMQ console.

Unsubscription method

To unsubscribe from an instance:

On the Unsubscriptions page in the Expenses and Costs console, select Partial Unsubscription, find the Message Queue for Apache RocketMQ instance that you want to unsubscribe, click Unsubscribe Resource in the Actions column, and follow the prompts to complete the unsubscription.

Related documents