AWS::EC2::IPAMAllocation - Amazon CloudFormation
SyntaxPropertiesReturn values
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::EC2::IPAMAllocation

In IPAM, an allocation is a CIDR assignment from an IPAM pool to another IPAM pool or to a resource.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::EC2::IPAMAllocation",
  "Properties" : {
      "Cidr" : String,
      "Description" : String,
      "IpamPoolId" : String,
      "NetmaskLength" : Integer
    }
}

YAML

Type: AWS::EC2::IPAMAllocation
Properties: 
  Cidr: String
  Description: String
  IpamPoolId: String
  NetmaskLength: Integer

Properties

Cidr

The CIDR you would like to allocate from the IPAM pool. Note the following:

  • If there is no DefaultNetmaskLength allocation rule set on the pool, you must specify either the NetmaskLength or the CIDR.

  • If the DefaultNetmaskLength allocation rule is set on the pool, you can specify either the NetmaskLength or the CIDR and the DefaultNetmaskLength allocation rule will be ignored.

Possible values: Any available IPv4 or IPv6 CIDR.

Required: No

Type: String

Update requires: Replacement

Description

A description for the allocation.

Required: No

Type: String

Update requires: Replacement

IpamPoolId

The ID of the IPAM pool from which you would like to allocate a CIDR.

Required: Yes

Type: String

Update requires: Replacement

NetmaskLength

The netmask length of the CIDR you would like to allocate from the IPAM pool. Note the following:

  • If there is no DefaultNetmaskLength allocation rule set on the pool, you must specify either the NetmaskLength or the CIDR.

  • If the DefaultNetmaskLength allocation rule is set on the pool, you can specify either the NetmaskLength or the CIDR and the DefaultNetmaskLength allocation rule will be ignored.

Possible netmask lengths for IPv4 addresses are 0 - 32. Possible netmask lengths for IPv6 addresses are 0 - 128.

Required: No

Type: Integer

Update requires: Replacement

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Reffunction, Refreturns the pool ID, allocation ID, and CIDR.

For more information about using the Reffunction, see Ref.

Fn::GetAtt

The Fn::GetAttintrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAttintrinsic function, see Fn::GetAtt.

IpamPoolAllocationId

The ID of an allocation.