Delete a pool - Amazon Virtual Private Cloud
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Delete a pool

An IPAM pool in Amazon represents a defined range of IP addresses that can be allocated and managed within a specific Amazon environment or organization. Pools are used to organize IP address space, enable automated IP address management, and enforce IP address governance policies across your cloud infrastructure.

You may want to delete an IPAM pool to remove unused or unnecessary IP address space and reclaim it for other purposes. You cannot delete an IP address pool if there are allocations in it. You must first release the allocations and Deprovision CIDRs from a pool before you can delete the pool.

Follow the steps in this section to delete an IPAM pool.

Amazon Management Console
To delete a pool

  1. Open the IPAM console at https://console.amazonaws.cn/ipam/.

  2. In the navigation pane, choose Pools.

  3. From the dropdown menu at the top of the content pane, choose the scope that you want to use. For more information about scopes, see How IPAM works.

  4. In the content pane, choose the pool whose CIDR you want to delete.

  5. Choose Actions > Delete pool.

  6. Enter delete and then choose Delete.

Command line

The commands in this section link to the Amazon CLI Reference documentation. The documentation provides detailed descriptions of the options that you can use when you run the commands.

Use the following Amazon CLI commands to delete a pool:

  1. View pools and get an IPAM pool ID: describe-ipam-pools

  2. Delete a pool: delete-ipam-pool

  3. View your pools: describe-ipam-pools

To create a new pool, see Create a top-level IPv4 pool.