All Products
Search

This Product

    ApsaraDB RDS:Promote the secondary instance to the primary instance

    Document Center

    ApsaraDB RDS:Promote the secondary instance to the primary instance

    Last Updated:Jul 03, 2025

    When all nodes of the primary ApsaraDB RDS for PostgreSQL instance in a Global Active Database (GAD) instance group become unavailable, you can quickly promote the secondary instance (disaster recovery instance) in the instance group to the primary primary instance with one click. After being promoted to the primary instance, the original secondary instance changes from the read-only state to the read/write state, which enables the quick recovery of your business. This feature is applicable to disaster recovery drill and cross-region disaster recovery scenarios.

    Prerequisites

    The GAD instance group is in the Running state.

    Precautions

    • Promoting a secondary instance to a primary instance may result in data loss. Exercise caution when you perform this operation. During the promotion, the connection to the instance group may be transiently interrupted. Make sure that your application can automatically reconnect to the instance group.

    • After the promotion, the original primary instance is removed from the instance group. The original one-way DTS synchronization task is stopped.

      The original primary instance is not released after being removed from the instance group. The data in the instance and related DTS synchronization account remain unchanged. You can still manage the instance on the Instances page.

      Note

      After the promotion, you can add the removed original primary instance back to the instance group as the new secondary instance. For more information, see Add or remove a secondary instance.

    Procedure

    1. Go to the Global Active Instances page.

    2. Click the ID of the instance group for which you want to perform a promotion.

    3. On the details page of the instance group, find the List of RDS Instances section at the bottom and click Upgrade to Primary Database in the Actions column corresponding to the secondary instance.

    4. Read the prompted notes and click OK.

    Related operations

    After promoting the secondary instance to the primary instance, evaluate your business and determine whether to update the connection information configured for your application with the endpoint of the new primary instance to connect to the new primary instance.