Изменение каталога
Чтобы изменить имя и описание каталога, используйте консоль управления, CLI, API или Terraform.
- Выберите каталог на стартовой странице
консоли управления. На этой странице отображаются каталоги для выбранного облака. Если необходимо, переключитесь на другое облако. - Нажмите значок
напротив каталога и выберите Редактировать. - Введите новое имя каталога и описание.
- Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
-
Посмотрите описание команды изменения каталога:
yc resource-manager folder update --help
-
Если вы знаете идентификатор или имя каталога, переходите к следующему шагу. Если нет, то узнайте это одним из способов:
-
Получите список каталогов:
yc resource-manager folder list
Результат:
+----------------------+--------------------+--------+--------+-------------+ | ID | NAME | LABELS | STATUS | DESCRIPTION | +----------------------+--------------------+--------+--------+-------------+ | b1gppulhhm2a******** | yet-another-folder | | ACTIVE | | | b1gvmob95yys******** | default | | ACTIVE | | +----------------------+--------------------+--------+--------+-------------+
- Если вы знаете идентификатор ресурса, который принадлежит нужному каталогу, получите идентификатор каталога из информации об этом ресурсе:
yc <имя_сервиса> <категория_сервиса> get <идентификатор_ресурса>
Где:
<имя_сервиса>
— имя сервиса, напримерcompute
.<категория_сервиса>
— категория ресурса, напримерinstance
.<идентификатор_ресурса>
— идентификатор ресурса.
Например, виртуальная машина
fhmp74bfis2a********
принадлежит каталогуb1gpvjd9ir42********
:yc compute instance get fhmp74bfis2a********
Результат:
id: fhmp74bfis2a******** folder_id: b1gpvjd9ia42******** ...
-
-
Измените параметры каталога, например имя и описание. Вы можете указать изменяемый каталог по имени или идентификатору.
yc resource-manager folder update default \ --new-name myfolder \ --description "this is my default-folder"
Команда переименует каталог
default
вmyfolder
и обновит его описание. Требования к имени каталога:- длина — от 3 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы изменить настройки каталога, созданный с помощью Terraform:
-
Откройте файл конфигурации Terraform и измените фрагмент с описанием каталога.
Пример описания каталога в конфигурации Terraform
... resource "yandex_resourcemanager_folder" "folder1" { cloud_id = "b1gia12lt1tp********" name = "myfolder" description = "this is my default-folder" } ...
Более подробную информацию о параметрах ресурса
yandex_resourcemanager_folder
в Terraform, см. в документации провайдера . -
Проверьте конфигурацию командой:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминал слово
yes
и нажмите Enter.Проверить изменение каталога можно в консоли управления
или с помощью команды CLI:yc resource-manager folder list-operations <имя_или_идентификатор_каталога>
Чтобы изменить каталог, воспользуйтесь методом REST API update для ресурса Folder или вызовом gRPC API FolderService/Update.