Deleting a cloud

If you do not have the Yandex Cloud CLI yet, install and initialize it.

1. View a description of the cloud delete command:

   yc resource-manager cloud delete --help
   

2. Get a list of available clouds:

   yc resource-manager cloud list
   

   Result:

   +----------------------+------------+----------------------+--------+
   |          ID          |    NAME    |   ORGANIZATION ID    | LABELS |
   +----------------------+------------+----------------------+--------+
   | b1g66mft1vop******** | my-cloud-1 | bpf2c65rqcl8******** |        |
   | b1gd129pp9ha******** | my-cloud-2 | bpf2c65rqcl8******** |        |
   +----------------------+------------+----------------------+--------+
   

3. Delete the cloud by specifying its name or ID:

   yc resource-manager cloud delete <cloud_name_or_ID> \
     --delete-after <cloud_deletion_delay> \
     --async
   

   Where:

   • --delete-after: Cloud deletion delay in HhMmSs format. Cloud deletion process will start after the specified delay. For example, --delete-after 22h30m50s.

     Specify 0s to delete the cloud now.

   • --async: Asynchronous deletion flag.

     Deleting a cloud can take up to 72 hours. Run the command in asynchronous mode to return to terminal management without waiting for the command to complete.

   Result:

   id: b1gqkbbj04d9********
   description: Delete cloud
   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.DeleteCloudMetadata
     cloud_id: b1g66mft1vop********
     delete_after: "2024-10-18T03:47:19.441433Z"
   

   Where id is the operation ID you can use to track the operation status later.

4. (Optional) Get information about the deletion operation status:

   yc operation get <operation_ID>
   

   After cloud deletion is complete, the response will contain the done field set to true (done: true).

For more information about the yc resource-manager cloud delete command, see the CLI reference.

If you do not have Terraform yet, install it and configure its Yandex Cloud provider.

To delete a cloud created using Terraform:

1. Open the Terraform configuration file and delete the fragment with the cloud description.

   Example cloud description in Terraform configuration

   ...
   resource "yandex_resourcemanager_cloud" "cloud1" {
     name            = "cloud-main"
     organization_id = "bpf7nhb9hkph********"
   }
   ...
   

   For more information about the yandex_resourcemanager_cloud resource parameters in Terraform, see the relevant provider documentation.

2. In the command line, change to the folder where you edited the configuration file.

3. Make sure the configuration file is correct 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 update using the management console or this CLI command:

   yc resource-manager cloud list
   

To delete the cloud, use the CloudService/Delete gRPC API call.