Skip to main content

ipam_pool

Gets an individual ipam_pool resource

Overview

Nameipam_pool
TypeResource
Descriptionipam_pool
Idawscc.ec2.ipam_pool

Fields

NameDatatypeDescription
ipam_pool_idstringId of the IPAM Pool.
address_familystringThe address family of the address space in this pool. Either IPv4 or IPv6.
allocation_min_netmask_lengthintegerThe minimum allowed netmask length for allocations made from this pool.
allocation_default_netmask_lengthintegerThe default netmask length for allocations made from this pool. This value is used when the netmask length of an allocation isn't specified.
allocation_max_netmask_lengthintegerThe maximum allowed netmask length for allocations made from this pool.
allocation_resource_tagsarrayWhen specified, an allocation will not be allowed unless a resource has a matching set of tags.
arnstringThe Amazon Resource Name (ARN) of the IPAM Pool.
auto_importbooleanDetermines what to do if IPAM discovers resources that haven't been assigned an allocation. If set to true, an allocation will be made automatically.
aws_servicestringLimits which service in Amazon Web Services that the pool can be used in.
descriptionstring
ipam_scope_idstringThe Id of the scope this pool is a part of.
ipam_scope_arnstringThe Amazon Resource Name (ARN) of the scope this pool is a part of.
ipam_scope_typestringDetermines whether this scope contains publicly routable space or space for a private network
ipam_arnstringThe Amazon Resource Name (ARN) of the IPAM this pool is a part of.
localestringThe region of this pool. If not set, this will default to "None" which will disable non-custom allocations. If the locale has been specified for the source pool, this value must match.
pool_depthintegerThe depth of this pool in the source pool hierarchy.
provisioned_cidrsarrayA list of cidrs representing the address space available for allocation in this pool.
public_ip_sourcestringThe IP address source for pools in the public scope. Only used for provisioning IP address CIDRs to pools in the public scope. Default is `byoip`.
publicly_advertisablebooleanDetermines whether or not address space from this pool is publicly advertised. Must be set if and only if the pool is IPv6.
source_ipam_pool_idstringThe Id of this pool's source. If set, all space provisioned in this pool must be free space provisioned in the parent pool.
source_resourceobject
statestringThe state of this pool. This can be one of the following values: "create-in-progress", "create-complete", "modify-in-progress", "modify-complete", "delete-in-progress", or "delete-complete"
state_messagestringAn explanation of how the pool arrived at it current state.
tagsarrayAn array of key-value pairs to apply to this resource.
regionstringAWS region.

Methods

Currently only SELECT is supported for this resource resource.

Example

SELECT
region,
ipam_pool_id,
address_family,
allocation_min_netmask_length,
allocation_default_netmask_length,
allocation_max_netmask_length,
allocation_resource_tags,
arn,
auto_import,
aws_service,
description,
ipam_scope_id,
ipam_scope_arn,
ipam_scope_type,
ipam_arn,
locale,
pool_depth,
provisioned_cidrs,
public_ip_source,
publicly_advertisable,
source_ipam_pool_id,
source_resource,
state,
state_message,
tags
FROM awscc.ec2.ipam_pool
WHERE data__Identifier = '<IpamPoolId>';

Permissions

To operate on the ipam_pool resource, the following permissions are required:

Read

ec2:DescribeIpamPools,
ec2:GetIpamPoolCidrs

Update

ec2:ModifyIpamPool,
ec2:DescribeIpamPools,
ec2:GetIpamPoolCidrs,
ec2:ProvisionIpamPoolCidr,
ec2:DeprovisionIpamPoolCidr,
ec2:CreateTags,
ec2:DeleteTags

Delete

ec2:DeleteIpamPool,
ec2:DescribeIpamPools,
ec2:GetIpamPoolCidrs,
ec2:DeprovisionIpamPoolCidr,
ec2:DeleteTags