This topic describes how to upgrade an ApsaraDB RDS for PostgreSQL instance from the Basic Edition to the High-availability Edition. The upgrade increases the reliability of your database service.


Your RDS instance runs one of the following PostgreSQL versions and RDS editions:

  • PostgreSQL 13 on RDS Basic Edition
  • PostgreSQL 12 on RDS Basic Edition
  • PostgreSQL 11 on RDS Basic Edition
  • PostgreSQL 10 on RDS Basic Edition
Note You can log on to the ApsaraDB RDS console, find your RDS instance, and then navigate to the Basic Information page to view the edition of your RDS instance.
Basic Edition

Background information

The High-availability Edition is a popular edition that allows for one primary RDS instance and one secondary RDS instance. These instances work in the high-availability architecture. This edition is suitable for more than 80% of the actual business scenarios, such as the Internet, Internet of Things (IoT), online retail, logistics, and gaming.

For more information, see RDS High-availability Edition.


For more information about the upgrade fee, see Specification change fees.


  • The upgrade may cause a migration of underlying data. Wait until the migration is completed. After the migration is completed, ApsaraDB RDS switches your workloads over to the High-availability Edition at the specified switching time. During the switchover, a transient connection error of about 30 seconds occurs. Make sure that your application is configured to automatically reconnect to your RDS instance.
  • You cannot roll back your RDS instance to the Basic Edition after the upgrade.


  1. Visit the RDS instance list, select a region above, and click the target instance ID.
  2. On the Basic Information page, click Change Specifications.
  3. In the dialog box that appears, select Upgrade and click Next. This step is required only when your RDS instance uses the subscription billing method.
  4. Configure the following parameters.
    Parameter Description
    Edition Select High-availability.
    Instance Type Select an instance type. Each instance type supports a specific number of CPU cores, memory capacity, maximum number of connections, and maximum input/output operations per second (IOPS). For more information, see Primary ApsaraDB RDS instance types.
    Capacity Specify the storage capacity. The storage capacity can only be increased but cannot be decreased.
    Switching Time Specify the time when you want to switch your workloads over to the High-availability Edition. Valid values:
    • Switch Immediately After Data Migration
    • Switch Within Maintenance Window
  5. Read and select Terms of Service, click Pay Now, and then complete the payment.

Related operations

API Description
Change instance configuration Changes the specifications of an ApsaraDB RDS instance.