After you enable the database proxy feature for an ApsaraDB RDS for PostgreSQL instance, the system generates a default proxy endpoint. You can create additional proxy endpoints, modify endpoint prefixes and ports, apply for or release public endpoints, and delete proxy endpoints that you no longer need.
Prerequisites
Before you begin, make sure that you have:
-
The database proxy feature enabled. For more information, see Enable the database proxy feature
Limits
| Item | Limit |
|---|---|
| Database proxy endpoints per instance | Up to 7 |
| Internal (VPC) endpoints per proxy endpoint | 1 (automatically allocated; cannot be deleted) |
| Public endpoints per proxy endpoint | 1 |
| Endpoint prefix length | 2 to 40 characters; lowercase letters, digits, and hyphens (-); must start with a lowercase letter |
| Public endpoint prefix length | 2 to 40 characters; lowercase letters, digits, and hyphens (-); must start with a lowercase letter |
| Port range | 1000 to 65534 |
| Default proxy endpoint | Cannot be deleted |
Database proxy endpoints were formerly known as proxy terminals.
Create a database proxy endpoint
-
Go to the Instances page. In the top navigation bar, select the region of your RDS instance and click the instance ID.
-
In the left-side navigation pane, click Database Proxy.
-
In the Connection Information section, click Create Proxy Endpoint.
-
In the dialog box, configure the connection settings. > Note: For more information about the connection settings, see Configure the connection settings for a database proxy endpoint.
-
Click OK.
After the proxy endpoint is created, the system allocates a virtual private cloud (VPC) internal endpoint for it. The allocation may take a few moments to complete. This internal endpoint cannot be deleted.
Modify a database proxy endpoint
-
Go to the Instances page. In the top navigation bar, select the region of your RDS instance and click the instance ID.
-
In the left-side navigation pane, click Database Proxy.
-
In the Connection Information section, find the proxy endpoint and click the
icon to its right. -
In the dialog box, modify the Endpoint prefix or the Port number, then click OK. > Note: The Endpoint Type value cannot be modified.
Apply for or release a public endpoint
Each database proxy endpoint supports one public endpoint. You can release the public endpoint but cannot release the internal endpoint.
Apply for a public endpoint
-
Go to the Instances page. In the top navigation bar, select the region of your RDS instance and click the instance ID.
-
In the left-side navigation pane, click Database Proxy.
-
In the Connection Information section, find the proxy endpoint and click Apply for Public Endpoint in the Public Endpoint/Port column.
-
Configure the Database Proxy Endpoint prefix and Port, then click OK.
Release a public endpoint
-
Go to the Instances page. In the top navigation bar, select the region of your RDS instance and click the instance ID.
-
In the left-side navigation pane, click Database Proxy.
-
In the Connection Information section, find the proxy endpoint and click Release Public Endpoint in the Public Endpoint/Port column.
Delete a database proxy endpoint
The default database proxy endpoint that is generated when you enable the database proxy cannot be deleted.
-
Go to the Instances page. In the top navigation bar, select the region of your RDS instance and click the instance ID.
-
In the left-side navigation pane, click Database Proxy.
-
Find the proxy endpoint and click Delete Connection in the Actions column. In the confirmation message, click OK.
References
API reference
| Operation | Description |
|---|---|
| DescribeDBProxy | Queries the details of a database proxy |
| DescribeDBProxyEndpoint | Queries information about a database proxy endpoint |
| CreateDBProxyEndpointAddress | Creates a database proxy endpoint |
| ModifyDBProxyEndpointAddress | Modifies a database proxy endpoint |
| DeleteDBProxyEndpointAddress | Deletes a database proxy endpoint |