Изменение каталога

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

1. Посмотрите описание команды изменения каталога:

   yc resource-manager folder update --help
   

2. Если вы знаете идентификатор или имя каталога, переходите к следующему шагу. Если нет, то узнайте это одним из способов:

   • Получите список каталогов:

     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********
     ...
     

3. Измените параметры каталога, например имя и описание. Вы можете указать изменяемый каталог по имени или идентификатору.

   yc resource-manager folder update default \
     --new-name myfolder \
     --description "this is my default-folder"
   

   Команда переименует каталог default в myfolder и обновит его описание. Требования к имени каталога:

   • длина — от 2 до 63 символов;
   • может содержать строчные буквы латинского алфавита, цифры и дефисы;
   • первый символ — буква, последний — не дефис.

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

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

1. Откройте файл конфигурации Terraform и измените фрагмент с описанием каталога.

   Пример описания каталога в конфигурации Terraform

   ...
   resource "yandex_resourcemanager_folder" "folder1" {
     cloud_id    = "b1gia12lt1tp********"
     name        = "myfolder"
     description = "this is my default-folder"
   }
   ...
   

   Более подробную информацию о параметрах ресурса yandex_resourcemanager_folder в Terraform, см. в документации провайдера.

2. Проверьте конфигурацию командой:

   terraform validate
   

   Если конфигурация является корректной, появится сообщение:

   Success! The configuration is valid.
   

3. Выполните команду:

   terraform plan
   

   В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

4. Примените изменения конфигурации:

   terraform apply
   

5. Подтвердите изменения: введите в терминал слово yes и нажмите Enter.

   Проверить изменение каталога можно в консоли управления или с помощью команды CLI:

   yc resource-manager folder list-operations <имя_или_идентификатор_каталога>
   

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