Class IpamPoolConfig

NetworkConfig / CentralNetworkServicesConfig / IpamConfig / IpamPoolConfig

VPC IPAM pool configuration. Use this configuration to define custom IPAM pools for your VPCs. A pool is a collection of contiguous IP address ranges. IPAM pools enable you to organize your IP addresses according to your routing and security needs.

Example

Base pool:

- name: accelerator-base-pool
  description: Base IPAM pool
  provisionedCidrs:
    - 10.0.0.0/16
  tags: []

Regional pool:

- name: accelerator-regional-pool
  description: Regional pool for us-east-1
  locale: us-east-1
  provisionedCidrs:
    - 10.0.0.0/24
  sourceIpamPool: accelerator-base-pool

Hierarchy

  • IpamPoolConfig

Implements

Constructors

constructor

Properties

addressFamily allocationDefaultNetmaskLength allocationMaxNetmaskLength allocationMinNetmaskLength allocationResourceTags autoImport description locale name provisionedCidrs publiclyAdvertisable scope shareTargets sourceIpamPool tags

Constructors

constructor

Properties

Readonly addressFamily

addressFamily: undefined | "ipv4" | "ipv6" = 'ipv4'

The address family for the IPAM pool.

Remarks

The default value is ipv4.

See

ipVersionEnum

Readonly allocationDefaultNetmaskLength

allocationDefaultNetmaskLength: undefined | number = undefined

(OPTIONAL) The default netmask length of IPAM allocations for this pool.

Remarks

Setting this property will enforce a default netmask length for all IPAM allocations in this pool.

Readonly allocationMaxNetmaskLength

allocationMaxNetmaskLength: undefined | number = undefined

(OPTIONAL) The maximum netmask length of IPAM allocations for this pool.

Remarks

Setting this property will enforce a maximum netmask length for all IPAM allocations in this pool. This value must be larger than the allocationMinNetmaskLength value.

Readonly allocationMinNetmaskLength

allocationMinNetmaskLength: undefined | number = undefined

(OPTIONAL) The minimum netmask length of IPAM allocations for this pool.

Remarks

Setting this property will enforce a minimum netmask length for all IPAM allocations in this pool. This value must be less than the allocationMaxNetmaskLength value.

Readonly allocationResourceTags

allocationResourceTags: undefined | Tag[] = undefined

(OPTIONAL) An array of tags that are required for resources that use CIDRs from this IPAM pool.

Remarks

Resources that do not have these tags will not be allowed to allocate space from the pool.

Readonly autoImport

autoImport: undefined | boolean = undefined

(OPTIONAL) If set to true, IPAM will continuously look for resources within the CIDR range of this pool and automatically import them as allocations into your IPAM.

Readonly description

description: undefined | string = undefined

(OPTIONAL) A description for the IPAM pool.

Readonly locale

locale: undefined | string = undefined

(OPTIONAL) The AWS Region where you want to make an IPAM pool available for allocations.

Remarks

CAUTION: Changing this value after initial deployment will cause the pool to be recreated. Please be aware that any downstream dependencies may cause this property update to fail.

Only resources in the same Region as the locale of the pool can get IP address allocations from the pool. A base (top-level) pool does not require a locale. A regional pool requires a locale.

Readonly name

name: string = ''

A friendly name for the IPAM pool.

Remarks

CAUTION: Changing this value after initial deployment will cause the pool to be recreated. Please be aware that any downstream dependencies may cause this property update to fail.

Readonly provisionedCidrs

provisionedCidrs: undefined | string[] = undefined

An array of CIDR ranges to provision for the IPAM pool.

Remarks

CAUTION: Changing or removing an existing provisioned CIDR range after initial deployment may impact downstream VPC allocations. Appending additional provisioned CIDR ranges does not impact downstream resources.

Use CIDR notation, i.e. 10.0.0.0/16. If defining a regional pool, the provisioned CIDRs must be a subset of the source IPAM pool's CIDR ranges.

Readonly publiclyAdvertisable

publiclyAdvertisable: undefined | boolean = undefined

(OPTIONAL) Determines if a pool is publicly advertisable.

Remarks

This option is not available for pools with AddressFamily set to ipv4.

Readonly scope

scope: undefined | string = undefined

(OPTIONAL) The friendly name of the IPAM scope to assign the IPAM pool to.

Remarks

Note: This is the logical name property of the scope as defined in network-config.yaml. Leave this property undefined to create the pool in the default private scope.

See

IpamScopeConfig

Readonly shareTargets

shareTargets: ShareTargets = ...

(OPTIONAL) Resource Access Manager (RAM) share targets.

Remarks

Targets can be account names and/or organizational units. Pools must be shared to any accounts/OUs that require IPAM allocations. The pool does not need to be shared with the delegated administrator account.

See

ShareTargets

Readonly sourceIpamPool

sourceIpamPool: undefined | string = undefined

(OPTIONAL) The friendly name of the source IPAM pool to create this IPAM pool from.

Remarks

Only define this value when creating regional IPAM pools. Leave undefined for top-level pools.

Readonly tags

tags: undefined | Tag[] = undefined

(OPTIONAL) An array of tag objects for the IPAM pool.

Settings

Member Visibility

Theme

Generated using TypeDoc