aws ec2 release-ipam-pool-allocation

To release an IPAM pool allocation

The following release-ipam-pool-allocation example releases an IPAM pool allocation. In this example, you're an IPAM delegated admin who tried to delete an IPAM pool but received an error that you cannot delete the pool while the pool has allocations. You are using this command to release a pool allocation.

Note the following:

You can only use this command for custom allocations. To remove an allocation for a resource without deleting the resource, set its monitored state to false using modify-ipam-resource-cidr.

To complete this request, you'll need the IPAM pool ID, which you can get with describe-ipam-pools. You'll also need the allocation ID, which you can get with get-ipam-pool-allocations.

If you do not want to remove allocations one by one, you can use the --cascade option when you delete an IPAM pool to automatically release any allocations in the pool before deleting it.

There are a number of prerequisites before running this command. For more information, see Release an allocation in the Amazon VPC IPAM User Guide.

The --region in which you run this command must be the locale of the IPAM pool where the allocation is.

To release the allocation, run the following command.

{
    "Success": true
}

Once you release an allocation, you may want to run delete-ipam-pool.