Skip to content

Latest commit

 

History

History
205 lines (146 loc) · 7.76 KB

delete-vpc-api.md

File metadata and controls

205 lines (146 loc) · 7.76 KB
Raw
copyright lastupdated keywords subcollection
years
2019
2019-05-07
vpc, delete, resources, api, rias
vpc

{:shortdesc: .shortdesc} {:new_window: target="_blank"} {:codeblock: .codeblock} {:pre: .pre} {:pre: .pre} {:screen: .screen} {:tip: .tip} {:important: .important} {:note: .note} {:download: .download} {:DomainName: data-hd-keyref="DomainName"}

Deleting a VPC using the REST APIs

{: #deleting-using-api}

Deleting an {{site.data.keyword.cloud}} Virtual Private Cloud using the REST APIs follows the same general steps in the deleting process as deletion by using the CLI.

Here are the main steps in the process:

  1. Find all subnets in the VPC you want to delete.
  2. Delete each subnet in the VPC, which means:
    • Delete all VPN gateways in the subnet.
    • Delete all Load Balancers in the subnet.
    • Delete all network interfaces (instances) in the subnet.
    • Delete the subnet.
  3. Delete all public gateways in the VPC.
  4. Delete the VPC.

The following sections provide some example API calls, using curl, which you can run to delete a VPC.

Step 1: Find all subnets in the VPC you want to delete

{: #deleting-find-subnets-api}

Before a VPC can be deleted, each of its subnets must be deleted. Get the ID of the VPC you want to delete by running the following command and looking at the id value:

Add | json_pp or | jq after the curl command to get a readable JSON string. {: tip}

curl -X GET "$rias_endpoint/v1/vpcs?version=$version&generation=1" \
     -H "Authorization:$iam_token"

{: pre}

Save the ID of the VPC in a variable so we can use it later, for example:

vpc="3524fef5-da35-4622-bf9a-31614964649d"

{: pre}

To get the list of all subnets in your account, run the following command:

curl -X GET "$rias_endpoint/v1/subnets?version=$version&generation=1" \     
     -H "Authorization:$iam_token"

{: pre}

Look at the vpc value to determine the subnets that need to be deleted. Save the ID of the subnet in a variable for later use, for example:

subnet="d31ce469-9b0f-44e1-87ce-0fc77d8b0e53"

{: pre}

If the VPC you want to delete has multiple subnets, repeat the steps to delete each subnet. {: important}

Step 2: Delete each subnet in the VPC

{: #deleting-subnet-resources-api}

Delete all VPN gateways in the subnet, if any

To list all VPN gateways in your account, run the following command:

curl -X GET "$rias_endpoint/v1/vpn_gateways?version=$version&generation=1" \
     -H "Authorization:$iam_token"

{: pre}

For each VPN gateway in the subnet you would like to delete, run the following command, where $vpnid is the ID of the VPN gateway.

curl -X DELETE "$rias_endpoint/v1/vpn_gateways/$vpnid?version=$version&generation=1" \     
     -H "Authorization:$iam_token"

{: pre}

The status of the VPN gateway should change to deleting immediately, but it will still be returned when doing a list query. The deletion of a VPN gateway can take up to 30 minutes. You can request other subnet resources to be deleted in parallel while waiting for the VPN gateway to be deleted, but the subnet cannot be deleted until the VPN gateway and all other resources in the subnet no longer appear in the list queries.

Delete all Load Balancers in the subnet, if any

{: #deleting-lbs-api}

To list all Load Balancers in your account, run the following command:

curl -X GET "$rias_endpoint/v1/load_balancers?version=$version&generation=1" \     
     -H "Authorization:$iam_token"

{: pre}

For each Load Balancer in the subnet you would like to delete, run the following command, where $lbid is the ID of the Load Balancer.

curl -X DELETE "$rias_endpoint/v1/load_balancers/$lbid?version=$version&generation=1" \     
     -H "Authorization:$iam_token"

{: pre}

The status of the Load Balancer should change to deleting immediately, but it will still be returned when doing a list query. The deletion of a Load Balancer can take up to 30 minutes. You can request other subnet resources to be deleted in parallel while waiting for the Load Balancer to be deleted, but the subnet cannot be deleted until the Load Balancer and all other resources in the subnet no longer appear in the list queries.

Delete all network interfaces in the subnet, if any

{: #deleting-nics-api}

An instance can have multiple network interfaces, and those network interfaces can belong to multiple subnets of the VPC. Before a subnet can be deleted, any network interface in the subnet must be deleted first. The only way to delete a network interface in a subnet is to delete the instance.

To list all instances in your account, run the following command:

curl -X GET "$rias_endpoint/v1/instances?version=$version&generation=1" \     
     -H "Authorization:$iam_token"

{: pre}

If you are deleting all instances in the VPC, you can run the following command for each instance in the VPC, where $vsi is the id of the instance you want to delete. When the instance is deleted, all network interfaces in other subnets, if any, will be deleted automatically.

curl -X DELETE "$rias_endpoint/v1/instances/$vsi?version=$version&generation=1" \     
     -H "Authorization:$iam_token"

{: pre}

The status of the instance should change to deleting immediately, but it still may be displayed in the results of a list query. The deletion of an instance can take up to 30 minutes. You can request other subnet resources to be deleted in parallel while waiting for the instance to be deleted, but the subnet cannot be deleted until the instance and all other resources in the subnet no longer appear in the list queries.

To list all network interfaces of an instance, run the following command:

curl -X GET "$rias_endpoint/v1/instances/$vsi/network_interfaces?version=$version&generation=1" \     
     -H "Authorization:$iam_token"

{: pre}

If a secondary network interface exists in the subnet you are trying to delete, you need to delete the instance. A network interface cannot be deleted from the instance without deleting the instance.

Delete the subnet

{: #deleting-subnet-api}

Once all the resources inside the subnet have been deleted and are not returned when running a list query, run the following command to delete the subnet:

curl -X DELETE "$rias_endpoint/v1/subnets/$subnet?version=$version&generation=1" \     
     -H "Authorization:$iam_token"

{: pre}

The status of the subnet should change to deleting immediately, but it may take a few minutes for the subnet to be deleted, so that it no longer returns in the list queries.

Step 3: Delete all public gateways in the VPC, if any

{: #deleting-pgs-api}

To list all public gateways in your account, run the following command:

curl -X GET "$rias_endpoint/v1/public_gateways?version=$version&generation=1" \     
     -H "Authorization:$iam_token"

{: pre}

For each public gateway in the VPC you want to delete, run the following command to delete the public gateway, where $gateway is the public gateway ID.

curl -X DELETE "$rias_endpoint/v1/public_gateways/$gateway?version=$version&generation=1" \     
     -H "Authorization:$iam_token"

{: pre}

Step 4: Delete the VPC

{: #deleting-single-vpc-api}

Once all subnets, VPN gateways, load balancers, public gateways in the VPC have been deleted, run the following command to delete the VPC, where $vpc is the ID of the VPC you are deleting.

curl -X DELETE "$rias_endpoint/v1/vpcs/$vpc?version=$version&generation=1" \     
     -H "Authorization:$iam_token"

{: pre}

The status of the VPC should change to deleting immediately, but it may take a few minutes for the VPC to be deleted, so that it no longer appears in the list queries.