Deleting a folder

If you do not have the Yandex Cloud command line interface yet, install and initialize it.

1. View a description of the folder delete command:

   yc resource-manager folder delete --help
   

2. If you know the folder ID or name, proceed to the next step. Otherwise, use one of these methods to get them:

   • Get a list of folders:

     yc resource-manager folder list
     

     Result:

     +----------------------+--------------------+--------+--------+-------------+
     |          ID          |        NAME        | LABELS | STATUS | DESCRIPTION |
     +----------------------+--------------------+--------+--------+-------------+
     | b1gppulhhm2a******** | yet-another-folder |        | ACTIVE |             |
     | b1gvmob95yys******** | default            |        | ACTIVE |             |
     +----------------------+--------------------+--------+--------+-------------+
     

     • If you know the ID of the resource that belongs to the required folder, you can get the folder ID from the information about that resource:

     yc <service_name> <service_category> get <resource_ID>
     

     Where:

     • <service_name>: Service name, e.g., compute.
     • <service_category>: Resource category, e.g., instance.
     • <resource_ID>: Resource ID.

     For example, the fhmp74bfis2a******** VM belongs to the b1gpvjd9ir42******** folder:

     yc compute instance get fhmp74bfis2a********
     

     Result:

     id: fhmp74bfis2a********
     folder_id: b1gpvjd9ia42********
     ...
     

3. Delete the folder:

   yc resource-manager folder delete <folder_ID>
   

   To display the details of an operation in progress before it is completed, set the --async flag.

If you don't have Terraform, install it and configure the Yandex Cloud provider.

To delete a folder created with Terraform:

1. Open the Terraform configuration file and delete the fragment describing the folder.

   Example folder description in a Terraform configuration

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

   For more information about the yandex_resourcemanager_folder parameters in Terraform, see the provider documentation.

2. In the command line, go to the folder with the Terraform configuration file.

3. Check the configuration using this command:

   terraform validate
   

   If the configuration is correct, you will get this message:

   Success! The configuration is valid.
   

4. Run this command:

   terraform plan
   

   The terminal will display a list of resources with parameters. No changes will be made at this step. If the configuration contains any errors, Terraform will point them out.

5. Apply the configuration changes:

   terraform apply
   

6. Confirm the changes: type yes into the terminal and press Enter.

   You can check the folder deletion using the management console or this CLI command:

   yc resource-manager folder list
   

To delete a folder, use the delete REST API method for the Folder resource or the FolderService/Delete gRPC API call.