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

You can change the internal and public endpoints and port numbers of an ApsaraDB RDS for SQL Server instance. This topic describes how to view and change the internal and public endpoints and port numbers.

Prerequisites

A whitelist is configured. For more information, see Configure an IP address whitelist.
A public endpoint for the RDS instance is available. For more information, see Apply for or release a public endpoint.

View the internal and public endpoints and port numbers of an RDS instance

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.
In the Basic Information section of the Basic Information page, click View Details to the right of Network Type. In the pane that appears, view the internal and public endpoints and port numbers of the RDS instance.

Change the internal or public endpoint and port number of an RDS instance

Important

If you change the endpoint or port number of your RDS instance, you must update the endpoint or port number information on your application. If you do not update the information, your application cannot connect to your RDS instance.

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.
In the left-side navigation pane, click Database Connection.
In the Database Connection section of the page that appears, click Modify Endpoint.
In the dialog box that appears, select a connection type, enter the prefix of the new endpoint, specify the port number, and then click Ok.
Note
- The prefix can contain lowercase letters, digits, and hyphens (-). The prefix must start with a lowercase letter and end with a lowercase letter or a digit.
- The prefix must contain at least 8 characters, and the total length of the endpoint cannot exceed 63 characters. The total length includes the prefix and suffix of the endpoint.
- The port number must be within the range of 1000 to 5999.

FAQ

After I change an endpoint or a port number of my RDS instance, do I need to update the endpoint or port number information in my application?
Yes, after you change an endpoint or a port number of your RDS instance, you must update the endpoint or port number information on your application. If you do not update the information, your application cannot connect to your RDS instance.
After I change an endpoint or a port number of my RDS instance, does the change immediately take effect? Do I need to restart my RDS instance?
After you change an endpoint or a port number of your RDS instance, the change immediately takes effect. You do not need to restart your RDS instance.
After I change or release an endpoint of my RDS instance, can I use the endpoint for another RDS instance?
Yes, you can change the network type of a read-only RDS instance and retain the classic network endpoint.
Does a primary/secondary switchover trigger changes to the endpoints of my RDS instance?
No, a primary/secondary switchover does not trigger changes to the endpoints of your RDS instance. However, the IP addresses that are associated with the endpoints change. Your application can still connect to your RDS instance by using the endpoints.