Delete an IPAM

You may want to delete an IPAM if it is no longer needed, if you need to restructure your IP address management, or if you want to start fresh with a new IPAM configuration. Deleting an IPAM can help simplify your IP address management and align with changing business or operational requirements.

Follow the steps in this section to delete an IPAM. For information on increasing the default number of IPAMs you can have rather than deleting an existing IPAM, see Quotas for your IPAM.

Note

Deleting an IPAM removes all monitored data associated with the IPAM including the historical data for CIDRs.

AWS Management Console

To delete an IPAM

1. Open the IPAM console at https://console.aws.amazon.com/ipam/.

2. In the navigation pane, choose IPAMs.

3. In the content pane, select your IPAM.

4. Choose Actions > Delete IPAM.

5. Do one of the following:

   • Choose Cascade delete to delete the IPAM, private scopes, pools in private scopes, and any allocations in the pools in private scopes. You cannot delete the IPAM with this option if there is a pool in your public scope. If you use this option, IPAM does the following:

     • Deallocates any CIDRs allocated to VPC resources (such as VPCs) in pools in private scopes.

       Note

       No VPC resources are deleted as a result of enabling this option. The CIDR associated with the resource will no longer be allocated from an IPAM pool, but the CIDR itself will remain unchanged.

     • Deprovisions all IPv4 CIDRs provisioned to IPAM pools in private scopes.

     • Deletes all IPAM pools in private scopes.

     • Deletes all non-default private scopes in the IPAM.

     • Deletes the default public and private scopes and the IPAM.

   • If you don't choose the Cascade delete checkbox, before you can delete an IPAM, you must do the following:

     • Release allocations within the IPAM pools. For more information, see Release an allocation.

     • Deprovision CIDRs provisioned to pools within the IPAM. For more information, see Deprovision CIDRs from a pool.

     • Delete any additional non-default scopes. For more information, see Delete a scope.

     • Delete your IPAM pools. For more information, see Delete a pool.

6. Enter delete and then choose Delete.

Command line

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

Use the following AWS CLI commands to delete an IPAM:

1. View current IPAMs: describe-ipams

2. Delete an IPAM: delete-ipam

3. View your updated IPAMs: describe-ipams

To create a new IPAM, see Create an IPAM.