This topic walks you through creating a managed PostgreSQL instance from the ApsaraDB RDS console. To create an instance via API, see Create an RDS instance.
Prerequisites
Before you begin, ensure that you have:
-
A RAM user with the AliyunRDSFullAccess and AliyunBSSOrderAccess policies attached. See Use RAM for resource authorization
Procedure
The ApsaraDB RDS buy page has a new version and an old version. Click New Version or Back to Old Version on the buy page to switch between them.
New version
-
Set the Billing Method.
To create a Serverless instance, see Create a serverless ApsaraDB RDS for PostgreSQL instance. The total price appears in the lower-right corner after all required parameters are set.
Billing method Best for How you're charged Subscription Long-running workloads Upfront fee; lower unit cost for longer terms Pay-as-you-go Short-term or variable workloads Hourly, based on actual usage; billing stops immediately on release Serverless Workloads with unpredictable peaks Based on resource consumption; CPU and memory scale automatically -
Set the Region.
-
To connect this instance to an Elastic Compute Service (ECS) instance over the internal network, select the region where the ECS instance resides. Instances in different regions cannot communicate over the internal network.
-
If your application runs on an on-premises server, select the region geographically closest to that server. Connect using the instance's public endpoint.
ImportantThe region cannot be changed after the instance is created.
-
-
Set the Database Engine, SLR Authorization, Edition, Product Type, and Storage Type.
-
Set Database Engine to PostgreSQL and select the version that fits your requirements. > Note: ApsaraDB RDS for PostgreSQL includes Babelfish, which enables instances running PostgreSQL 13, 14, or 15 to accept T-SQL statements. If you need to connect a SQL Server application or client to a PostgreSQL instance, select Enable Babelfish during creation. See Introduction to Babelfish.
-
Set SLR Authorization. If this is your first time creating an RDS for PostgreSQL instance, click Authorize to grant the
AliyunServiceRoleForRdsPgsqlOnEcsservice-linked role (SLR). This allows the instance to attach Elastic Network Interfaces (ENIs) and establish network connections. Authorization is required only once and incurs no charges. -
Set the Edition.
Edition Architecture Suitable for Basic Edition Single primary instance Personal learning, microsites, dev/test environments for small and medium-sized enterprises. Restart and fault recovery take longer than other editions. High-availability Edition Primary + secondary instance in HA mode; supports read-only instances Production databases for large and medium-sized enterprises; internet, IoT, e-commerce, logistics, gaming Cluster Edition (recommended) Primary node + multiple readable secondary nodes in HA mode Production databases for large and medium-sized enterprises; internet-based new retail, automotive, ERP systems NoteNote: Available editions vary by region and PostgreSQL version. See Overview of ApsaraDB RDS editions.
-
Set Product Type. Valid values: Standard and YiTian. > Note: This parameter does not apply to Basic Edition. For High-availability Edition and Cluster Edition, see Product types.
-
Set Storage Type.
ESSD (recommended) General ESSD Scalability Up to 64 TB; no transient connections during expansion; automatic storage expansion supported Online expansion in seconds Performance PL1 < PL2 < PL3. PL2 delivers 2x the IOPS and throughput of PL1. PL3 delivers up to 20x the IOPS and 11x the throughput of PL1. Higher baseline I/O than PL1 ESSD; supports I/O burst, I/O acceleration, and data archiving Backup frequency Up to once every 15 minutes Up to once every 15 minutes NoteNote: Available storage types vary by database engine and edition. For ESSD or General ESSD, enable Cloud Disk Encryption to protect data at rest. See Use the cloud disk encryption feature and General ESSDs.
-
-
Set the Network Type (fixed as VPC).
-
Set VPC. For the instance to communicate with an ECS instance over the internal network, both must reside in the same region and the same virtual private cloud (VPC). Instances in different VPCs cannot connect over the internal network, even within the same region. > Note: Instances in the same VPC can connect over the internal network even if they use different vSwitches.
-
Set Add to Whitelist.
-
Yes: The CIDR block of the selected VPC is added to the instance whitelist, allowing ECS instances in that VPC to connect.
-
No: Configure the whitelist after creation. See Configure an IP address whitelist.
-
-
-
Select a zone, a vSwitch, and a Deployment Method.
-
Zone: No substantive difference exists between zones in the same region. For best performance, place the RDS instance in the same zone as the ECS instance running your application. Cross-zone instances in the same region perform slightly lower than same-zone instances.
-
vSwitch: Select an existing vSwitch or click Create vSwitch. See Create and manage a vSwitch.
-
Deployment Method:
Method Description Multi-zone Deployment (recommended) Primary and secondary instances reside in different zones, providing zone-level disaster recovery. Configure Zone and Network of Primary Node and Zone and Network of Secondary Node. Single-zone Deployment Primary and secondary instances share the same zone. Basic Edition supports this method only.
If a zone shows Sold Out, it lacks sufficient resources. Select a different zone.
-
-
Set the Instance Type.
-
Set Category.
Category Resources Best for General-purpose Exclusively owns memory and I/O; shares CPU and storage with other instances on the same host Cost-sensitive workloads Dedicated Exclusively owns CPU, memory, storage, and I/O. The dedicated host subtype exclusively owns all resources on the physical host. Performance-sensitive or stability-critical workloads. Not available for Basic Edition. -
Select a specific instance type (CPU cores, memory, max connections, max IOPS). See Primary ApsaraDB RDS instance types for the full list.
-
Test environments: 2+ cores
-
Production environments: 4+ cores
-
-
-
Set the Storage Capacity. The available range depends on the instance type and storage type. Adjust in 5 GB increments.
-
(Subscription only) Set the Subscription Duration.
-
Baseline Price: The list price without discounts.
-
Preferential Monthly Fee: The monthly price derived from the baseline price.
-
Price: Hover over View Details on the right to see the estimated total based on duration and baseline price.
Displayed prices are based on list price only and exclude coupons or promotions.
-
-
(Optional) Configure additional parameters. Default values work for most use cases. The minor engine version follows this format:
Parameter Description Port Port for the instance. Valid values: 1000–5999. Default: 5432. Parameter Template Apply a parameter template at creation time. If none is selected, the default system template is used. See Use a parameter template. Release Protection Pay-as-you-go instances only. Prevents accidental release. See Enable or disable release protection. Minor Engine Version Update Policy Defaults to Automatic Upgrade. When the minor engine version is outdated, the system schedules an O&M task within your configured maintenance window and notifies you by email or internal message. Pin a specific AliPG minor version at creation time; if none is specified, the latest AliPG version is used. See Release notes for AliPG. After creation, modify this setting on the Basic Information page. See Update the minor engine version. Resource Group The resource group for this instance. Retain the default or select a custom group. Babelfish Migration Mode Applies only when Enable Babelfish is selected. Choose single-db (one SQL Server database per instance, standard PostgreSQL schema) or multi-db (multiple SQL Server databases, schemas named <Database name>_<Schema name>). See Migration modes.Initial Account (Babelfish only) Username for the Babelfish management account used to connect over the TDS port. This is a privileged account and cannot be deleted after creation. Password (Babelfish only) Password for the Babelfish management account. See Reset a password. Time Zone Configurable on the primary instance only; read-only instances inherit the primary's time zone. The time zone is not in UTC. If not specified, the region's default time zone is applied. See Common time zones and Region-to-time-zone mappings. Instance Description A custom name to help identify the instance. Tags Add tags to distinguish and filter instances. See Use tags to filter instances. Privileged Account Create a privileged account now, or select Configure Later to do it after creation. See Create a database and an account. Field Description Example rdsRDS instance — postgresPostgreSQL database — 1400Major PostgreSQL version 14 20220830AliPG version 20220830 14.4Minor PostgreSQL version 14.4 rds_postgres_1400_20220830_14.4With Babelfish enabled, the format is:
rds_postgres_1400_20220630_babelfish_14.4 -
In the upper-right corner, set Quantity (default: 1; maximum: 20 per purchase).
-
Review the configuration, read and accept the ApsaraDB RDS Terms of Service, then click Pay Now to complete payment. For Subscription instances, also confirm the subscription duration. The console displays Congratulations or The service is activated when the instance is ready.
For Subscription instances, enable Auto-renewal to prevent service interruptions if you forget to renew. The auto-renewal cycle matches your subscription term: one month for monthly subscriptions, one year for yearly subscriptions. Disable auto-renewal at any time. See Use the auto-renewal feature.
-
Go to the Instances page. In the top navigation bar, select the region where you created the instance, then find it by Creation Time.
Instance creation takes 1–10 minutes. Refresh the page if the instance is not yet visible.
Old version
Step 1: Configure basic settings
-
Set the Billing Method. See the billing method table in the new version for descriptions.
-
Set the Region.
-
To connect this instance to an ECS instance over the internal network, select the region where the ECS instance resides. Instances in different regions cannot communicate over the internal network.
-
If your application runs on an on-premises server, select the region geographically closest to that server.
ImportantThe region cannot be changed after the instance is created.
-
-
Set the Database Engine, Edition, Product Type, and Storage Type. See the corresponding tables in the new version for full descriptions.
-
Set Database Engine to PostgreSQL and select the version that fits your requirements. > Note: ApsaraDB RDS for PostgreSQL includes Babelfish, which enables instances running PostgreSQL 13, 14, or 15 to accept T-SQL statements. If you need to connect a SQL Server application or client to a PostgreSQL instance, select Enable Babelfish during creation. See Introduction to Babelfish.
-
Set the Edition (Basic Edition, High-availability Edition, or Cluster Edition).
-
Set Product Type. Valid values: Standard and YiTian.
-
Set Storage Type (ESSD or General ESSD).
-
-
Select a zone and set the Deployment Method.
-
Zone: For best performance, place the RDS instance in the same zone as the ECS instance running your application.
-
Deployment Method:
-
Multi-zone Deployment (recommended): Primary and secondary instances reside in different zones, providing zone-level disaster recovery. Configure Zone of Primary Node and Zone of Secondary Node.
-
Single-zone Deployment: Primary and secondary instances share the same zone. Basic Edition supports this method only.
-
If a zone shows Sold Out, it lacks sufficient resources. Select a different zone.
-
-
Set the Instance Type (category and specific type). See step 7 in the new version for full details.
-
Test environments: 2+ cores
-
Production environments: 4+ cores
-
-
Set the Storage Capacity. Adjust in 5 GB increments.
-
(Subscription only) Set the Subscription Duration.
-
In the lower-right corner, click Next: Instance Configuration.
Step 2: Configure advanced settings
-
Set the Network Type (fixed as VPC).
-
Set VPC and vSwitch of Primary Node. Both the RDS instance and the ECS instance must reside in the same region and the same VPC for internal network communication. > Note: Instances in the same VPC can connect over the internal network even if they use different vSwitches. For Multi-zone Deployment, also set vSwitch of Secondary Node.
-
Set Add to Whitelist.
-
Yes: The CIDR block of the selected VPC is added to the instance whitelist, allowing ECS instances in that VPC to connect.
-
No: Configure the whitelist after creation. See Configure an IP address whitelist.
-
-
Set Port. Valid values: 1000–5999. Default: 5432.
-
-
Set Parameter Template. Apply a parameter template at creation time. If none is selected, the default system template is used. See Use a parameter template.
-
Set Release Protection (pay-as-you-go instances only). Prevents accidental release. See Enable or disable release protection.
-
Set Minor Engine Version Update Policy. Defaults to Automatic Upgrade. When the minor engine version is outdated, the system schedules an O&M task within your configured maintenance window and notifies you by email or internal message. See Set the maintenance window. Pin a specific AliPG minor version at creation time; if none is specified, the latest AliPG version is used. The version string follows this format:
After creation, modify this setting on the Basic Information page. See Update the minor engine version.
Field Description Example rdsRDS instance — postgresPostgreSQL database — 1400Major PostgreSQL version 14 20220830AliPG version 20220830 14.4Minor PostgreSQL version 14.4 rds_postgres_1400_20220830_14.4With Babelfish enabled:
rds_postgres_1400_20220630_babelfish_14.4 -
Set Resource Group. Retain the default or select a custom resource group.
-
(Babelfish only) Configure Babelfish parameters. These parameters apply only when Enable Babelfish is selected in the Basic Resources step.
-
Babelfish Migration Mode:
-
single-db: One SQL Server database per instance; uses a standard PostgreSQL schema.
-
multi-db: Multiple SQL Server databases; schemas are named
<Database name>_<Schema name>to avoid conflicts. See Migration modes.
-
-
Initial Account: Username for the Babelfish management account, used to connect over the TDS port. > Important: This is a privileged account and cannot be deleted after creation.
-
Password: Password for the Babelfish management account. See Reset a password.
-
-
Set Time Zone. Configurable on the primary instance only; read-only instances inherit the primary's time zone. The time zone is not in UTC. If not specified, the region's default time zone is applied. See Common time zones and Region-to-time-zone mappings.
-
Set SLR Authorization. If this is the first time you create an RDS instance after October 10, 2022, authorize the
AliyunServiceRoleForRdsPgsqlOnEcsSLR. This allows the instance to attach ENIs and establish network connections. Authorization is required only once and incurs no charges. See [Product changes] SLR authorization is required from October 10, 2022. -
(Optional) Set the Instance Description to give the instance a meaningful name.
-
(Optional) Set Privileged Account. Create a privileged account now, or select Configure Later to do it after creation. See Create a database and an account.
-
In the lower-right corner, click Next: Confirm Order.
Step 3: Confirm order
-
Review the configuration in the Parameter Configuration section. Set Quantity and (for Subscription) Subscription Duration, accept the Terms of Service, then click Pay Now.
For Subscription instances, enable Auto-renewal to prevent service interruptions if you forget to renew. The auto-renewal cycle matches your subscription term: one month for monthly subscriptions, one year for yearly subscriptions. Disable auto-renewal at any time. See Use the auto-renewal feature.
-
Go to the Instances page. In the top navigation bar, select the region where you created the instance, then find it by Creation Time.
Instance creation takes 1–10 minutes. Refresh the page if the instance is not yet visible.
What's next
FAQ
How do I view the total number of RDS instances in my Alibaba Cloud account?
Log on to the ApsaraDB RDS console and go to the Overview page. The page shows the total instance count by database engine, the regions where instances are deployed, and the number of running instances per region.
I just created an RDS instance, but I can't find it. What should I do?
Check the following:
| Cause | Fix |
|---|---|
| Wrong region selected | In the top navigation bar, select the region where you created the instance. |
| Insufficient zone resources | The instance creation may have failed. Go to the Orders page in Billing Management to check for a refund, then retry in a different zone. |
| RAM policy blocks unencrypted instances | If your RAM user has a policy requiring encryption, create the instance with ESSD or General ESSD storage and enable Cloud Disk Encryption. See Use RAM policies to manage permissions. |