All Products
Search
Document Center

ApsaraDB RDS:View and change the internal and public endpoints and port numbers

Last Updated:Mar 28, 2026

To connect to an ApsaraDB RDS for MariaDB instance, you need the endpoint and port number. This page shows you how to find those values on the Database Connection page and how to change them.

Endpoint types

ApsaraDB RDS for MariaDB provides two endpoint types. Both endpoint types are suitable for all connection scenarios.

Endpoint typeWhen to use
Internal endpointConnect an Elastic Compute Service (ECS) instance to an RDS instance over an internal network when both are in the same virtual private cloud (VPC). Provides low latency and high stability.
Public endpointConnect to an RDS instance over the Internet — for example, from a local machine or an application outside the VPC.

View or change an endpoint and port number

  1. Go to the Instances page. In the top navigation bar, select the region where the RDS instance resides. Find the instance and click its ID.

  2. In the left-side navigation pane, click Database Connection. The Database Connection page shows the current internal and public endpoints and port numbers.

  3. To change an endpoint or port number, click Modify Endpoint.

  4. In the dialog box, select a connection type, enter a new endpoint prefix, specify a port number, and then click OK. The prefix must meet the following requirements: The port number must be in the range of 1000 to 65534.

    RequirementDetails
    Allowed charactersLowercase letters, digits, and hyphens (-)
    Start characterLowercase letter
    End characterLowercase letter or digit
    Minimum prefix length8 characters
    Maximum total endpoint length63 characters (prefix + suffix combined)
Important

After changing an endpoint or port number, update the connection settings in your application. If you do not update them, your application cannot connect to the RDS instance.

FAQ

Do I need to restart the RDS instance when I change the endpoint or port number?

No. Changing the endpoint or port number does not require an instance restart.

After I change or release an endpoint, can another RDS instance use it?

Yes. Released endpoints become available for other RDS instances.