Discuss with expertTry it for free
© 2026 Direct Cursus Technology L.L.C.

Managing MySQL® cluster aliases

Written by
Updated at September 8, 2026
View in Markdown

You can assign each MySQL® cluster an alias, which is a custom network name. An alias is mapped to a specific DNS record which always points to the master host of the cluster associated with the alias. This allows you to access the cluster using a human-readable name, regardless of internal host FQDNs. The alias must be unique within the folder. You can assign only one alias per cluster.

To switch your apps to another cluster in the same folder, all you need to do is change the cluster-alias association.

Alias format:

c-<alias_name>-my-<folder_ID>.rw.mdb.yandexcloud.net

Note

When creating an alias, you only specify its name.

Getting the cluster alias

Viewing the alias requires the managed-mysql.viewer role or higher for the folder.

  1. Navigate to Managed Service for MySQL.

  2. Click the cluster name.

    The cluster alias is displayed in the CNAME alias field.

Creating a cluster alias

Creating an alias requires the managed-mysql.editor role or higher for the folder.

Warning

Due to DNS propagation, it may take some time for the alias to become available after the operation completes.

  1. Navigate to Managed Service for MySQL.
  2. Click the cluster name and click in the CNAME alias section.
  3. In the window that opens, specify a name for the cluster alias. Use only lowercase Latin letters, numbers, and hyphens. The alias may be up to 63 characters long.
  4. Click Create alias.

Moving an alias between clusters

You can move an alias only between clusters in the same folder. Moving an alias requires the managed-mysql.editor role or higher for the folder.

Warning

Due to DNS propagation, it may take some time for the alias to become available after the operation completes.

  1. Navigate to Managed Service for MySQL.

  2. You can move the alias in one of these two ways:

    • In the settings of the cluster with the alias:

      1. Click the name of the cluster whose alias you want to move to another cluster in your folder, and then in the CNAME alias section.
      2. In the window that opens, select the cluster to associate the alias with.

    • In the settings of the cluster to move the alias to.

      1. Click the name of the cluster to which you want to move the alias of another cluster in your folder, and then in the CNAME alias section.
      2. In the window that opens, select the cluster the alias is associated with.

  3. Confirm moving the cluster and click Move alias.

Deleting an alias

Deleting an alias requires the managed-mysql.editor role or higher for the folder.

  1. Navigate to Managed Service for MySQL.
  2. Click the cluster name and then, in the CNAME alias section.
  3. In the window that opens, confirm the alias deletion.
Previous
Updating a cluster
Next
Stopping and restarting a cluster