Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

awscc.ec2.ipam_pool

CloudFormation Type: AWS::EC2::IPAMPool

Resource Schema of AWS::EC2::IPAMPool Type

Example

let ipam = awscc.ec2.ipam {
  description = "Example IPAM"
  tier        = free

  operating_region {
    region_name = "ap-northeast-1"
  }
}

awscc.ec2.ipam_pool {
  ipam_scope_id  = ipam.private_default_scope_id
  address_family = "IPv4"
  locale         = "ap-northeast-1"
  description    = "Example IPv4 IPAM Pool"

  provisioned_cidr {
    cidr = "10.0.0.0/8"
  }

  tags = {
    Environment = "example"
  }
}

Argument Reference

address_family

The address family of the address space in this pool. Either IPv4 or IPv6.

allocation_default_netmask_length

  • Type: Int
  • Required: No

The 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_length

  • Type: Int
  • Required: No

The maximum allowed netmask length for allocations made from this pool.

allocation_min_netmask_length

  • Type: Int
  • Required: No

The minimum allowed netmask length for allocations made from this pool.

allocation_resource_tags

  • Type: List<Map>
  • Required: No

When specified, an allocation will not be allowed unless a resource has a matching set of tags.

auto_import

  • Type: Bool
  • Required: No

Determines 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_service

Limits which service in Amazon Web Services that the pool can be used in.

description

  • Type: String
  • Required: No

ipam_scope_id

  • Type: String
  • Required: Yes

The Id of the scope this pool is a part of.

locale

  • Type: Region
  • Required: No

The 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.

provisioned_cidrs

A list of cidrs representing the address space available for allocation in this pool.

public_ip_source

The 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_advertisable

  • Type: Bool
  • Required: No

Determines 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_id

  • Type: IpamPoolId
  • Required: No

The Id of this pool’s source. If set, all space provisioned in this pool must be free space provisioned in the parent pool.

source_resource

tags

  • Type: Map
  • Required: No

An array of key-value pairs to apply to this resource.

Enum Values

address_family (AddressFamily)

ValueDSL Identifier
IPv4awscc.ec2.ipam_pool.AddressFamily.IPv4
IPv6awscc.ec2.ipam_pool.AddressFamily.IPv6

Shorthand formats: IPv4 or AddressFamily.IPv4

aws_service (AwsService)

ValueDSL Identifier
ec2awscc.ec2.ipam_pool.AwsService.ec2
global-servicesawscc.ec2.ipam_pool.AwsService.global_services

Shorthand formats: ec2 or AwsService.ec2

ipam_scope_type (IpamScopeType)

ValueDSL Identifier
publicawscc.ec2.ipam_pool.IpamScopeType.public
privateawscc.ec2.ipam_pool.IpamScopeType.private

Shorthand formats: public or IpamScopeType.public

public_ip_source (PublicIpSource)

ValueDSL Identifier
byoipawscc.ec2.ipam_pool.PublicIpSource.byoip
amazonawscc.ec2.ipam_pool.PublicIpSource.amazon

Shorthand formats: byoip or PublicIpSource.byoip

state (State)

ValueDSL Identifier
create-in-progressawscc.ec2.ipam_pool.State.create_in_progress
create-completeawscc.ec2.ipam_pool.State.create_complete
modify-in-progressawscc.ec2.ipam_pool.State.modify_in_progress
modify-completeawscc.ec2.ipam_pool.State.modify_complete
delete-in-progressawscc.ec2.ipam_pool.State.delete_in_progress
delete-completeawscc.ec2.ipam_pool.State.delete_complete

Shorthand formats: create_in_progress or State.create_in_progress

Struct Definitions

ProvisionedCidr

FieldTypeRequiredDescription
cidrCidrYes

SourceResource

FieldTypeRequiredDescription
resource_idStringYes
resource_ownerStringYes
resource_regionRegionYes
resource_typeStringYes

Attribute Reference

arn

  • Type: Arn

ipam_arn

  • Type: Arn

ipam_pool_id

  • Type: IpamPoolId

ipam_scope_arn

  • Type: Arn

ipam_scope_type

pool_depth

  • Type: Int

state

state_message

  • Type: String