Help Center/ GaussDB(for MySQL)/ User Guide/ Instance Management/ Instance Lifecycle Management/ Changing a DB Instance or Node Name
Updated on 2024-11-06 GMT+08:00
View PDF
Share

Changing a DB Instance or Node Name

Scenarios

You can change the name of a GaussDB(for MySQL) instance or its node for easy identification.

  1. Log in to the management console.
  2. Click in the upper left corner and select a region and project.
  3. Click in the upper left corner of the page and choose Databases > GaussDB(for MySQL).
  4. On the Instances page, locate a DB instance and click in the Name/ID column to edit the DB instance name.

    Figure 1 Changing a DB instance name on the Instances page

    Alternatively, click the instance name to go to the Basic Information page. Locate DB Instance Name in the Instance Information area, and click to edit the instance name.

    Figure 2 Changing a DB instance name on the Basic Information page

    • The instance name must start with a letter and consist of 4 to 64 characters. Only uppercase letters, lowercase letters, digits, hyphens (-), and underscores (_) are allowed.
    • When changing the instance name, you can determine whether to select Change node names synchronously as required. If this option is selected, the names of the corresponding nodes are changed when the instance name is changed. If this option is not selected, only the instance name is changed, and the corresponding node names are not changed.
    • If you want to submit the change, click OK. If you want to cancel the change, click Cancel.

  5. Check that the instance name has been changed. It takes less than 1 minute to change a DB instance name.
  1. Log in to the management console.
  2. Click in the upper left corner and select a region and project.
  3. Click in the upper left corner of the page and choose Databases > GaussDB(for MySQL).
  4. On the Instances page, click the instance name to go to the Basic Information page.
  5. In the Node List area, select one or more nodes, click Change Node Name.

    Figure 3 Changing node names

    Alternatively, click next to a node name to edit the node name.

    • The node name must start with a letter and consist of 4 to 128 characters. Only letters (case-sensitive), digits, hyphens (-), and underscores (_) are allowed.
    • The node name must be unique.

  6. Click OK to submit the change.
  7. Check that the node name has been changed.

APIs

Parent Topic: Instance Lifecycle Management