Переименование облака

Статья создана

Улучшена

Обновлена 16 января 2025 г.

Чтобы переименовать облако, у вас должна быть роль editor или выше на это облако. Переименовать заблокированное облако нельзя. Если вы не можете выполнить эту операцию, обратитесь к администратору или владельцу облака.

Консоль управления

CLI

Terraform

API

В консоли управления в списке слева выберите нужное облако.
В правом верхнем углу страницы нажмите значок и выберите Редактировать.
В открывшемся окне введите новое имя облака. Требования к имени:
- длина — от 2 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
Нажмите Сохранить.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

Посмотрите описание команды для изменения облака:
```
yc resource-manager cloud update --help
```

Посмотрите список доступных облаков:

yc resource-manager cloud list

Результат:

+----------------------+------------------+----------------------+--------+
|          ID          |       NAME       |   ORGANIZATION ID    | LABELS |
+----------------------+------------------+----------------------+--------+
| b1go33ek97iq******** | my-cloud         | bpf2c65rqcl8******** |        |
| b1gbi30tq0m9******** | my-new-cloud     | bpfaidqca8vd******** |        |
+----------------------+------------------+----------------------+--------+

Выполните команду, чтобы переименовать облако:
```
yc resource-manager cloud update \
  --name <текущее_имя_облака> \
  --new-name <новое_имя_облака>
```
Где:
- --name — текущее имя облака, которое требуется изменить. Вместо имени облака вы можете передать его идентификатор в параметре --id.
- --new-name — новое имя облака.
  - длина — от 2 до 63 символов;
  - может содержать строчные буквы латинского алфавита, цифры и дефисы;
  - первый символ — буква, последний — не дефис.
Результат:
```
id: b1go33ek97iq********
created_at: "2024-12-10T09:25:22Z"
name: my-old-cloud
organization_id: bpf2c65rqcl8********
```

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы переименовать облако, созданное с помощью Terraform:

Откройте файл конфигурации Terraform и измените значение параметра name во фрагменте с описанием облака.
Пример описания облака в конфигурации Terraform
```
...
resource "yandex_resourcemanager_cloud" "cloud1" {
  name            = "cloud-main"
  organization_id = "bpf7nhb9hkph********"
}
...
```
Более подробную информацию о параметрах ресурса yandex_resourcemanager_cloud в Terraform, см. в документации провайдера.
В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
Проверьте корректность конфигурационного файла с помощью команды:
```
terraform validate
```
Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
Выполните команду:
```
terraform plan
```
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
Примените изменения конфигурации:
```
terraform apply
```
Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

Проверить измененное имя облака можно в консоли управления или с помощью команды CLI:
```
yc resource-manager cloud list
```

Чтобы переименовать облако, воспользуйтесь методом REST API update для ресурса Cloud или вызовом gRPC API CloudService/Update.

Переименование облака

Была ли статья полезна?