All Products
Search
Document Center

ApsaraDB RDS:Configure database proxy endpoints

Last Updated:Oct 09, 2026

If you do not want to use the default proxy endpoint that is automatically generated, RDS for PostgreSQL allows you to customize the address prefix to simplify management. You can also modify the port of an endpoint, apply for a public endpoint, or release a public endpoint.

Prerequisites

The database proxy service is enabled. For more information, see Enable the database proxy.

Usage notes

  • A single RDS for PostgreSQL instance supports 1 to 7 proxy endpoints. For each proxy endpoint, you can apply for one private address in a Virtual Private Cloud (VPC) and one public endpoint.

  • When you enable the database proxy, the service creates one default proxy endpoint. This default endpoint cannot be deleted.

  • When you add a new proxy endpoint, the service automatically creates a private address for it in the Virtual Private Cloud (VPC). This private address cannot be deleted.

Add a proxy endpoint

  1. Go to the Instances page. In the top navigation bar, select the region in which the RDS instance resides. Then, find the RDS instance and click the ID of the instance.

  2. In the left-side navigation pane, click Database Proxy.

  3. In the Connection Information section, click Create Proxy Endpoint.

  4. In the dialog box, configure an access policy for the proxy endpoint.

    Note

    For more information about proxy endpoint access policies, see Configure an access policy for a database proxy endpoint.

  5. Click OK.

Modify a proxy endpoint and port

  1. Go to the Instances page. In the top navigation bar, select the region in which the RDS instance resides. Then, find the RDS instance and click the ID of the instance.

  2. In the left-side navigation pane, click Database Proxy.

  3. In the Connection Information section, find the target proxy endpoint and click the image.png icon next to the endpoint.

  4. In the dialog box, set the Endpoint and Port, and then click OK.

    Note
    • Address prefix: Must start with a lowercase letter and be 2 to 40 characters long. It can include letters, digits, and hyphens (-).

    • Port range: 1000 to 5999.

    • You cannot modify the address type.

Apply for or release a public endpoint

  1. Go to the Instances page. In the top navigation bar, select the region in which the RDS instance resides. Then, find the RDS instance and click the ID of the instance.

  2. In the left-side navigation pane, click Database Proxy.

  3. In the connection information section, find the target proxy endpoint and click Public Endpoint/Port or Release Public Endpoint in the Apply for Public Endpoint column.

    If you click Apply for Public Endpoint, set the address prefix and Port for the public endpoint in the dialog box, and then click OK.

    Note
    • Each proxy endpoint supports only one public endpoint.

    • Address prefix: Must start with a lowercase letter and be 2 to 40 characters long. It can include letters, digits, and hyphens (-).

    • Port range: 1000 to 5999.

    • You can only release public endpoints. You cannot release private addresses.

Delete a proxy endpoint

  1. Go to the Instances page. In the top navigation bar, select the region in which the RDS instance resides. Then, find the RDS instance and click the ID of the instance.

  2. In the left-side navigation pane, click Database Proxy.

  3. Find the target proxy endpoint, click Delete Connection to the right of the endpoint, and then click OK in the confirmation dialog box.

    Note

    You cannot delete the default proxy endpoint created when you enable the database proxy service.

Related topics

API reference

API

Description

DescribeDBProxy

Queries the details of a database proxy.

DescribeDBProxyEndpoint

Queries the endpoint information of a database proxy.

CreateDBProxyEndpointAddress

Creates a database proxy endpoint.

ModifyDBProxyEndpointAddress

Modifies a database proxy endpoint.

DeleteDBProxyEndpointAddress

Deletes a database proxy endpoint.