File: //usr/lib/python3/dist-packages/awscli/examples/ec2/allocate-ipam-pool-cidr.rst
**To allocate a CIDR from an IPAM pool**
The following ``allocate-ipam-pool-cidr`` example allocates a CIDR from an IPAM pool.
(Linux)::
    aws ec2 allocate-ipam-pool-cidr \
        --ipam-pool-id ipam-pool-0533048da7d823723 \
        --netmask-length 24
(Windows)::
     aws ec2 allocate-ipam-pool-cidr ^
        --ipam-pool-id ipam-pool-0533048da7d823723 ^
        --netmask-length 24
Output::
    {
        "IpamPoolAllocation": {
            "Cidr": "10.0.0.0/24",
            "IpamPoolAllocationId": "ipam-pool-alloc-018ecc28043b54ba38e2cd99943cebfbd",
            "ResourceType": "custom",
            "ResourceOwner": "123456789012"
        }
    }
For more information, see `Manually allocate a CIDR to a pool to reserve IP address space <https://docs.aws.amazon.com/vpc/latest/ipam/manually-allocate-ipam.html>`__ in the *Amazon VPC IPAM User Guide*.