Deleting a subnet
Alert
Before deleting a subnet, disassociate all the resources from it.
You cannot restore a subnet after it is deleted.
- In the management console
, go to the folder where you need to delete a subnet. - In the list of services, select Virtual Private Cloud.
- In the left-hand panel, select
Subnets. - Click
in the row of the subnet you need and select Delete. - In the window that opens, click Delete.
If you do not have the Yandex Cloud CLI installed yet, install and initialize it.
By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID>
command. You can also set a different folder for any specific command using the --folder-name
or --folder-id
parameter.
-
View the description of the CLI command for deleting a subnet:
yc vpc subnet delete --help
-
Get a list of all subnets in the default folder:
yc vpc subnet list
Result:
+----------------------+-----------------------+------------------------+ | ID | NAME | ... | RANGE | +----------------------+-----------------------+------------------------+ ... | e2l0psbfoloe******** | test-subnet-1 | ... | [192.168.0.0/24] | ... +----------------------+-----------------------+-----+------------------+
-
Select the
ID
orNAME
of the subnet you need. -
Delete the subnet from the default folder:
yc vpc subnet delete test-subnet-1
If you do not have Terraform yet, install it and configure the Yandex Cloud provider.
With Terraform
Terraform is distributed under the Business Source License
For more information about the provider resources, see the relevant documentation on the Terraform
To delete a subnet created using Terraform:
-
Open the Terraform configuration file and delete the fragment with the subnet description.
Example of a subnet description in the Terraform configuration
... resource "yandex_vpc_subnet" "lab-subnet-a" { name = "subnet-1" description = "My first subnet" v4_cidr_blocks = ["10.2.0.0/16"] zone = "ru-central1-a" network_id = "${yandex_vpc_network.lab-net.id}" } ...
-
In the command line, navigate to the directory with the Terraform configuration file.
-
Check the configuration using this command:
terraform validate
If the configuration is correct, you will get this message:
Success! The configuration is valid.
-
Run this command:
terraform plan
You will see a detailed list of resources. No changes will be made at this step. If the configuration contains errors, Terraform will show them.
-
Apply the changes:
terraform apply
-
Type
yes
and press Enter to confirm changes.You can check the update using the management console
or these CLI commands:yc vpc subnet list
To delete a subnet, use the delete REST API method for the Subnet resource or the SubnetService/Delete gRPC API call and provide the ID of the subnet to delete in the subnetId
request parameter.
To get the subnet ID, use the list REST API method for the Subnet resource or the SubnetService/List gRPC API call and provide the folder ID in the folderId
request parameter.
To learn how to find out the folder ID, see Getting the folder ID.
Examples
Deleting a subnet from a particular folder
Delete a subnet from a different folder:
yc vpc subnet delete test-subnet-2 --folder-id b1gnbfd11bq5********
Where folder_id
is the folder ID.
yc vpc subnet delete test-subnet-2 --folder-name test-folder
Where --folder-name
is the folder name.
You can provide the ID and name not only as positional arguments, but also using the --id
and --name
parameters:
yc vpc subnet delete --id enpavfmgapum********
yc vpc subnet delete --name test-network-1