Удаление каталога
Чтобы удалить каталог, у вас должна быть роль resource-manager.editor или выше на этот каталог. Если вы не можете выполнить эту операцию, обратитесь к администратору или владельцу каталога.
- Выберите каталог на стартовой странице
консоли управления. На этой странице отображаются каталоги для выбранного облака. Если необходимо, переключитесь на другое облако. - Нажмите значок
напротив каталога и выберите Удалить. - Выберите срок удаления каталога, по истечении которого каталог будет удален. Выберите один из возможных периодов или
Удалить сейчас
. По умолчанию срок удаления каталога — 7 дней. - Нажмите Удалить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
-
Посмотрите описание команды удаления каталога:
yc resource-manager folder delete --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 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
— идентификатор операции, с помощью которого вы сможете позднее отследить ее статус. -
-
(Опционально) Получите информацию о статусе операции удаления:
yc operation get <идентификатор_операции>
После завершения удаления каталога, ответ будет содержать поле
done
со значениемtrue
(done: true
).
Подробнее о команде yc resource-manager folder delete
см. в справочнике CLI.
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы удалить каталог, созданный с помощью Terraform:
-
Откройте файл конфигурации Terraform и удалите фрагмент с описанием каталога.
Пример описания каталога в конфигурации Terraform
... resource "yandex_resourcemanager_folder" "folder1" { cloud_id = "b1gia12lt1tp********" name = "new-folder" description = "this is my default-folder" } ...
Более подробную информацию о параметрах ресурса
yandex_resourcemanager_folder
в Terraform, см. в документации провайдера . -
В командной строке перейдите в папку, где расположен конфигурационный файл Terraform.
-
Проверьте конфигурацию командой:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминал слово
yes
и нажмите Enter.Проверить удаление каталога можно в консоли управления
или с помощью команды CLI:yc resource-manager folder list
Чтобы удалить каталог, воспользуйтесь методом REST API delete для ресурса Folder или вызовом gRPC API FolderService/Delete.
Ресурсы будут остановлены, каталог перейдет в статус ожидания удаления PENDING_DELETION
. Удаление каталога, находящегося в статусе PENDING_DELETION
, можно отменить. Для этого в консоли управления
Внимание
Пока каталог находится в статусе PENDING_DELETION
, ваши диски, зарезервированные IP-адреса и другие данные продолжают храниться и тарифицироваться.
Пока каталог находится в статусе DELETING
тарификация платных ресурсов продолжается, если метрики фиксируют их потребление.
Стоимость хранения рассчитывается по прежнему тарифу. Следите за тарификацией ресурсов в сервисе Yandex Cloud Billing
После завершения периода ожидания каталог переходит в статус DELETING
. В этом статусе происходит процесс необратимого удаления, занимающий до 72 часов. В результате вместе с каталогом будут удалены все его ресурсы.
Удаление каталога может быть отменено системой, если в нем есть ресурсы, которые нельзя удалить. Подробнее см. в разделе Причины невозможности удаления каталогов. После отмены удаления каталог вернется в статус ACTIVE
, а пользователь получит сообщение с описанием причин, которые не позволили удалить каталог.