Help Center/ Relational Database Service_RDS for MariaDB/ User Guide/ Instance Connection/ Connection Management/ Changing a Database Port
Updated on 2025-06-24 GMT+08:00
View PDF
Share

Changing a Database Port

Scenarios

This section describes how to change the database port of a primary DB instance or a read replica. For primary/standby DB instances, changing the database port of the primary DB instance will cause the database port of the standby DB instance to also be changed.

If specific security group rules have been configured for a DB instance, you need to change the inbound rules of the security group to which the DB instance belongs after changing the database port.

Constraints

When the database port of a DB instance is being changed, you cannot:

  • Bind an EIP to the DB instance.
  • Delete the DB instance.
  • Create a backup for the DB instance.

Procedure

  1. Log in to the management console.
  2. Click in the upper left corner and select a region and a project.
  3. Click in the upper left corner of the page and choose Databases > Relational Database Service.
  4. On the Instances page, click the target DB instance or click first and then click the target read replica.
  5. On the Overview page, find Database Port and click Configure under it.

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

    RDS for MariaDB instances can use database ports 1024 to 65535, excluding 12017 and 33071, which are reserved for RDS system use.

  6. In the displayed dialog box, enter a new port and click Yes.

    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. For details about how to enable operation protection, see Identity and Access Management User Guide.

    • If you change the database port of the primary DB instance, that of the standby DB instance will also be changed and both DB instances will be rebooted.
    • If you change the database port of a read replica, the change will not affect other DB instances. Only the read replica will be rebooted.
    • This process takes 1 to 5 minutes.

  7. Check the results on the Overview page.
Parent topic: Connection Management