Удаление каталога

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

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

   yc resource-manager folder delete --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 delete <имя_или_идентификатор_каталога> \
     --delete-after <срок_удаления_каталога> \
     --async
   

   Где:

   • --delete-after — срок удаления каталога в формате HhMmSs. Процесс удаления каталога начнется по истечении заданного срока. Например: --delete-after 22h30m50s.

     Чтобы удалить каталог сейчас, укажите 0s.

   • --async — флаг асинхронного удаления.

     Удаление каталога может занять до 72 часов. Выполняйте команду в асинхронном режиме, чтобы вернуть управление терминалом, не дожидаясь завершения выполнения команды.

   Результат:

   id: b1gqkbbj04d9********
   description: Delete folder
   created_at: "2024-10-17T05:16:30.648219069Z"
   created_by: ajei280a73vc********
   modified_at: "2024-10-17T05:16:30.648219069Z"
   metadata:
     '@type': type.googleapis.com/yandex.cloud.resourcemanager.v1.DeleteFolderMetadata
     folder_id: b1g66mft1vop********
     delete_after: "2024-10-18T03:47:19.441433Z"
   

   Где id — идентификатор операции, с помощью которого вы сможете позднее отследить ее статус.

4. (Опционально) Получите информацию о статусе операции удаления:

   yc operation get <идентификатор_операции>
   

   После завершения удаления каталога, ответ будет содержать поле done со значением true (done: true).

Подробнее о команде yc resource-manager folder delete см. в справочнике CLI.

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

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

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

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

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

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

2. В командной строке перейдите в папку, где расположен конфигурационный файл Terraform.

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

   terraform validate
   

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

   Success! The configuration is valid.
   

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

   terraform plan
   

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

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

   terraform apply
   

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

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

   yc resource-manager folder list
   

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