Updated on 2025-08-20 GMT+08:00

Changing a Private Domain Name

You can connect to RDS DB instances through private domain names.

Constraints

  • Changing the private domain name will interrupt your database connection. To reconnect to the instance, change the connection address of your applications. The new private domain name is applied to the instance about 5 minutes after the change.
  • If your DB instance is connected through a private domain name, changing its floating IP address does not interrupt services.

Procedure

When you buy a DB instance, the system automatically assigns a private domain name to your instance.

After the DB instance is created, you can change the private domain name as needed.

  1. Click in the upper left corner and select a region.
  2. Click in the upper left corner of the page and choose Databases > Relational Database Service.
  3. On the Instances page, click the instance name to go to the Overview page.
  4. Under Private Domain Name, click Configure.

    Alternatively, in the navigation pane on the left, choose Connectivity & Security. On the displayed page, click Change next to the Private Domain Name field.

  5. In the displayed dialog box, enter a new domain name and click Yes.

    • Only the prefix of a private domain name can be modified.
    • The prefix of a private domain name contains 8 to 63 characters, and can include only letters and digits.
    • The new private domain name must be different from existing ones.

  6. If you have enabled operation protection, click Send Code in the displayed Identity Verification dialog box and enter the obtained verification code. Then, click OK.

    Two-factor authentication improves the security of your account and cloud product. For details about how to enable operation protection, see Identity and Access Management User Guide.

FAQ

  • Question 1: Do I Need to Change the Connection Domain Name for My Application After Changing the Private Domain Name of My DB Instance?

    Changing the private domain name on the console will interrupt database connections. To reconnect your application to the DB instance, you need to change the domain name for the application.

  • Question 2: Does the New Private Domain Name Is Applied Immediately? Is an Instance Reboot Required?

    The new domain name is applied immediately. You do not need to reboot the DB instance.

  • Question 3: Does the IP Address of a DB Instance Change After a Primary/Standby Switchover?

    A primary/standby switchover does not change the connection information of an instance, including the VPC, subnet, security group, floating IP address, private domain name, and database port.