Renaming a cloud
To rename a cloud, you must have the editor
role or higher for that cloud. You cannot rename a suspended cloud. If you cannot perform this operation, contact the cloud administrator or owner.
-
In the management console
, select the appropriate cloud from the list on the left. -
In the top-right corner of the page, click
and select Edit. -
In the window that opens, enter a new cloud name. The naming requirements are as follows:
- The name must be from 3 to 63 characters long.
- It may contain lowercase Latin letters, numbers, and hyphens.
- The first character must be a letter and the last character cannot be a hyphen.
-
Click Save.
If you don't have Terraform, install it and configure the Yandex Cloud provider.
To rename a cloud created using Terraform:
-
Open the Terraform configuration file and edit the value of the
name
parameter in the part with the cloud description.Example cloud description in Terraform configuration
... resource "yandex_resourcemanager_cloud" "cloud1" { name = "cloud-main" organization_id = "bpf7nhb9hkph********" } ...
For more information about the
yandex_resourcemanager_cloud
parameters in Terraform, see the provider documentation . -
In the command line, change to the folder where you edited the configuration file.
-
Make sure the configuration file is correct using this command:
terraform validate
If the configuration is correct, you will get this message:
Success! The configuration is valid.
-
Run this command:
terraform plan
The terminal will display a list of resources with parameters. No changes will be made at this step. If the configuration contains any errors, Terraform will point them out.
-
Apply the configuration changes:
terraform apply
-
Confirm the changes: type
yes
into the terminal and press Enter.You can verify the updated cloud name in the management console
or the following CLI command:yc resource-manager cloud list
To rename a cloud, use the update REST API method for the Cloud resource or the CloudService/Update gRPC API call.