This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::CloudFront::AnycastIpList
<a name="aws-resource-cloudfront-anycastiplist"></a>

An Anycast static IP list. For more information, see [Request Anycast static IPs to use for allowlisting](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/request-static-ips.html) in the *Amazon CloudFront Developer Guide*.

## Syntax
<a name="aws-resource-cloudfront-anycastiplist-syntax"></a>

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

### JSON
<a name="aws-resource-cloudfront-anycastiplist-syntax.json"></a>

```
{
  "Type" : "AWS::CloudFront::AnycastIpList",
  "Properties" : {
      "[IpAddressType](#cfn-cloudfront-anycastiplist-ipaddresstype)" : String,
      "[IpamCidrConfigs](#cfn-cloudfront-anycastiplist-ipamcidrconfigs)" : [ IpamCidrConfig, ... ],
      "[IpCount](#cfn-cloudfront-anycastiplist-ipcount)" : Integer,
      "[Name](#cfn-cloudfront-anycastiplist-name)" : String,
      "[Tags](#cfn-cloudfront-anycastiplist-tags)" : Tags
    }
}
```

### YAML
<a name="aws-resource-cloudfront-anycastiplist-syntax.yaml"></a>

```
Type: AWS::CloudFront::AnycastIpList
Properties:
  [IpAddressType](#cfn-cloudfront-anycastiplist-ipaddresstype): String
  [IpamCidrConfigs](#cfn-cloudfront-anycastiplist-ipamcidrconfigs): 
    - IpamCidrConfig
  [IpCount](#cfn-cloudfront-anycastiplist-ipcount): Integer
  [Name](#cfn-cloudfront-anycastiplist-name): String
  [Tags](#cfn-cloudfront-anycastiplist-tags): 
    Tags
```

## Properties
<a name="aws-resource-cloudfront-anycastiplist-properties"></a>

`IpAddressType`  <a name="cfn-cloudfront-anycastiplist-ipaddresstype"></a>
The IP address type for the Anycast static IP list.  
*Required*: No  
*Type*: String  
*Allowed values*: `ipv4 | dualstack`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`IpamCidrConfigs`  <a name="cfn-cloudfront-anycastiplist-ipamcidrconfigs"></a>
A list of IPAM CIDR configurations that define the IP address ranges, IPAM pools, and associated Anycast IP addresses.  
*Required*: No  
*Type*: Array of [IpamCidrConfig](aws-properties-cloudfront-anycastiplist-ipamcidrconfig.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`IpCount`  <a name="cfn-cloudfront-anycastiplist-ipcount"></a>
The number of IP addresses in the Anycast static IP list.  
*Required*: Yes  
*Type*: Integer  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Name`  <a name="cfn-cloudfront-anycastiplist-name"></a>
The name of the Anycast static IP list.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^[a-zA-Z0-9-_]{1,64}$`  
*Minimum*: `1`  
*Maximum*: `64`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Tags`  <a name="cfn-cloudfront-anycastiplist-tags"></a>
A complex type that contains zero or more `Tag` elements.  
*Required*: No  
*Type*: [Tags](aws-properties-cloudfront-anycastiplist-tags.md)  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

## Return values
<a name="aws-resource-cloudfront-anycastiplist-return-values"></a>

### Ref
<a name="aws-resource-cloudfront-anycastiplist-return-values-ref"></a>

When you pass the logical ID of this resource to the intrinsic `Ref` function, `Ref` returns the ID of the Anycast IP list. For example: `aip_7XdPQUqEXAMPLE283z455j`.

For more information about using the `Ref` function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html).

### Fn::GetAtt
<a name="aws-resource-cloudfront-anycastiplist-return-values-fn--getatt"></a>

The `Fn::GetAtt` intrinsic 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::GetAtt` intrinsic function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html).

#### 
<a name="aws-resource-cloudfront-anycastiplist-return-values-fn--getatt-fn--getatt"></a>

`ETag`  <a name="ETag-fn::getatt"></a>
A complex type that contains `Tag` key and `Tag` value.

`Id`  <a name="Id-fn::getatt"></a>
The ID of the Anycast static IP list.

`IpamCidrConfigResults`  <a name="IpamCidrConfigResults-fn::getatt"></a>
The results for the IPAM CIDRs that defines a specific IP address range, IPAM pool, and associated Anycast IP address.

# AWS::CloudFront::AnycastIpList AnycastIpList
<a name="aws-properties-cloudfront-anycastiplist-anycastiplist"></a>

An Anycast static IP list. For more information, see [Request Anycast static IPs to use for allowlisting](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/request-static-ips.html) in the *Amazon CloudFront Developer Guide*.

## Syntax
<a name="aws-properties-cloudfront-anycastiplist-anycastiplist-syntax"></a>

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

### JSON
<a name="aws-properties-cloudfront-anycastiplist-anycastiplist-syntax.json"></a>

```
{
  "[AnycastIps](#cfn-cloudfront-anycastiplist-anycastiplist-anycastips)" : [ String, ... ],
  "[Arn](#cfn-cloudfront-anycastiplist-anycastiplist-arn)" : String,
  "[Id](#cfn-cloudfront-anycastiplist-anycastiplist-id)" : String,
  "[IpAddressType](#cfn-cloudfront-anycastiplist-anycastiplist-ipaddresstype)" : String,
  "[IpamCidrConfigResults](#cfn-cloudfront-anycastiplist-anycastiplist-ipamcidrconfigresults)" : [ IpamCidrConfigResult, ... ],
  "[IpCount](#cfn-cloudfront-anycastiplist-anycastiplist-ipcount)" : Integer,
  "[LastModifiedTime](#cfn-cloudfront-anycastiplist-anycastiplist-lastmodifiedtime)" : String,
  "[Name](#cfn-cloudfront-anycastiplist-anycastiplist-name)" : String,
  "[Status](#cfn-cloudfront-anycastiplist-anycastiplist-status)" : String
}
```

### YAML
<a name="aws-properties-cloudfront-anycastiplist-anycastiplist-syntax.yaml"></a>

```
  [AnycastIps](#cfn-cloudfront-anycastiplist-anycastiplist-anycastips): 
    - String
  [Arn](#cfn-cloudfront-anycastiplist-anycastiplist-arn): String
  [Id](#cfn-cloudfront-anycastiplist-anycastiplist-id): String
  [IpAddressType](#cfn-cloudfront-anycastiplist-anycastiplist-ipaddresstype): String
  [IpamCidrConfigResults](#cfn-cloudfront-anycastiplist-anycastiplist-ipamcidrconfigresults): 
    - IpamCidrConfigResult
  [IpCount](#cfn-cloudfront-anycastiplist-anycastiplist-ipcount): Integer
  [LastModifiedTime](#cfn-cloudfront-anycastiplist-anycastiplist-lastmodifiedtime): String
  [Name](#cfn-cloudfront-anycastiplist-anycastiplist-name): String
  [Status](#cfn-cloudfront-anycastiplist-anycastiplist-status): String
```

## Properties
<a name="aws-properties-cloudfront-anycastiplist-anycastiplist-properties"></a>

`AnycastIps`  <a name="cfn-cloudfront-anycastiplist-anycastiplist-anycastips"></a>
The static IP addresses that are allocated to the Anycast static IP list.  
*Required*: Yes  
*Type*: Array of String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Arn`  <a name="cfn-cloudfront-anycastiplist-anycastiplist-arn"></a>
The Amazon Resource Name (ARN) of the Anycast static IP list.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Id`  <a name="cfn-cloudfront-anycastiplist-anycastiplist-id"></a>
The ID of the Anycast static IP list.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`IpAddressType`  <a name="cfn-cloudfront-anycastiplist-anycastiplist-ipaddresstype"></a>
The IP address type for the Anycast static IP list.  
*Required*: No  
*Type*: String  
*Allowed values*: `ipv4 | dualstack`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`IpamCidrConfigResults`  <a name="cfn-cloudfront-anycastiplist-anycastiplist-ipamcidrconfigresults"></a>
The results for the IPAM CIDRs that defines a specific IP address range, IPAM pool, and associated Anycast IP address.  
*Required*: No  
*Type*: Array of [IpamCidrConfigResult](aws-properties-cloudfront-anycastiplist-ipamcidrconfigresult.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`IpCount`  <a name="cfn-cloudfront-anycastiplist-anycastiplist-ipcount"></a>
The number of IP addresses in the Anycast static IP list.  
*Required*: Yes  
*Type*: Integer  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`LastModifiedTime`  <a name="cfn-cloudfront-anycastiplist-anycastiplist-lastmodifiedtime"></a>
The last time the Anycast static IP list was modified.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Name`  <a name="cfn-cloudfront-anycastiplist-anycastiplist-name"></a>
The name of the Anycast static IP list.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^[a-zA-Z0-9-_]{1,64}$`  
*Minimum*: `1`  
*Maximum*: `64`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Status`  <a name="cfn-cloudfront-anycastiplist-anycastiplist-status"></a>
The status of the Anycast static IP list. Valid values: `Deployed`, `Deploying`, or `Failed`.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::CloudFront::AnycastIpList IpamCidrConfig
<a name="aws-properties-cloudfront-anycastiplist-ipamcidrconfig"></a>

Configuration for an IPAM CIDR that defines a specific IP address range, IPAM pool, and associated Anycast IP address.

## Syntax
<a name="aws-properties-cloudfront-anycastiplist-ipamcidrconfig-syntax"></a>

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

### JSON
<a name="aws-properties-cloudfront-anycastiplist-ipamcidrconfig-syntax.json"></a>

```
{
  "[Cidr](#cfn-cloudfront-anycastiplist-ipamcidrconfig-cidr)" : String,
  "[IpamPoolArn](#cfn-cloudfront-anycastiplist-ipamcidrconfig-ipampoolarn)" : String
}
```

### YAML
<a name="aws-properties-cloudfront-anycastiplist-ipamcidrconfig-syntax.yaml"></a>

```
  [Cidr](#cfn-cloudfront-anycastiplist-ipamcidrconfig-cidr): String
  [IpamPoolArn](#cfn-cloudfront-anycastiplist-ipamcidrconfig-ipampoolarn): String
```

## Properties
<a name="aws-properties-cloudfront-anycastiplist-ipamcidrconfig-properties"></a>

`Cidr`  <a name="cfn-cloudfront-anycastiplist-ipamcidrconfig-cidr"></a>
The CIDR that specifies the IP address range for this IPAM configuration.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`IpamPoolArn`  <a name="cfn-cloudfront-anycastiplist-ipamcidrconfig-ipampoolarn"></a>
The Amazon Resource Name (ARN) of the IPAM pool that the CIDR block is assigned to.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::CloudFront::AnycastIpList IpamCidrConfigResult
<a name="aws-properties-cloudfront-anycastiplist-ipamcidrconfigresult"></a>

The result for the IPAM CIDR that defines a specific IP address range, IPAM pool, and associated Anycast IP address.

## Syntax
<a name="aws-properties-cloudfront-anycastiplist-ipamcidrconfigresult-syntax"></a>

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

### JSON
<a name="aws-properties-cloudfront-anycastiplist-ipamcidrconfigresult-syntax.json"></a>

```
{
  "[AnycastIp](#cfn-cloudfront-anycastiplist-ipamcidrconfigresult-anycastip)" : String,
  "[Cidr](#cfn-cloudfront-anycastiplist-ipamcidrconfigresult-cidr)" : String,
  "[IpamPoolArn](#cfn-cloudfront-anycastiplist-ipamcidrconfigresult-ipampoolarn)" : String,
  "[Status](#cfn-cloudfront-anycastiplist-ipamcidrconfigresult-status)" : String
}
```

### YAML
<a name="aws-properties-cloudfront-anycastiplist-ipamcidrconfigresult-syntax.yaml"></a>

```
  [AnycastIp](#cfn-cloudfront-anycastiplist-ipamcidrconfigresult-anycastip): String
  [Cidr](#cfn-cloudfront-anycastiplist-ipamcidrconfigresult-cidr): String
  [IpamPoolArn](#cfn-cloudfront-anycastiplist-ipamcidrconfigresult-ipampoolarn): String
  [Status](#cfn-cloudfront-anycastiplist-ipamcidrconfigresult-status): String
```

## Properties
<a name="aws-properties-cloudfront-anycastiplist-ipamcidrconfigresult-properties"></a>

`AnycastIp`  <a name="cfn-cloudfront-anycastiplist-ipamcidrconfigresult-anycastip"></a>
The specified Anycast IP address allocated from the IPAM pool for this CIDR configuration.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Cidr`  <a name="cfn-cloudfront-anycastiplist-ipamcidrconfigresult-cidr"></a>
The CIDR that specifies the IP address range for this IPAM configuration.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`IpamPoolArn`  <a name="cfn-cloudfront-anycastiplist-ipamcidrconfigresult-ipampoolarn"></a>
The Amazon Resource Name (ARN) of the IPAM pool that the CIDR block is assigned to.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Status`  <a name="cfn-cloudfront-anycastiplist-ipamcidrconfigresult-status"></a>
The current status of the IPAM CIDR configuration.  
*Required*: No  
*Type*: String  
*Allowed values*: `provisioned | failed-provision | provisioning | deprovisioned | failed-deprovision | deprovisioning | advertised | failed-advertise | advertising | withdrawn | failed-withdraw | withdrawing`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::CloudFront::AnycastIpList Tag
<a name="aws-properties-cloudfront-anycastiplist-tag"></a>

A complex type that contains `Tag` key and `Tag` value.

## Syntax
<a name="aws-properties-cloudfront-anycastiplist-tag-syntax"></a>

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

### JSON
<a name="aws-properties-cloudfront-anycastiplist-tag-syntax.json"></a>

```
{
  "[Key](#cfn-cloudfront-anycastiplist-tag-key)" : String,
  "[Value](#cfn-cloudfront-anycastiplist-tag-value)" : String
}
```

### YAML
<a name="aws-properties-cloudfront-anycastiplist-tag-syntax.yaml"></a>

```
  [Key](#cfn-cloudfront-anycastiplist-tag-key): String
  [Value](#cfn-cloudfront-anycastiplist-tag-value): String
```

## Properties
<a name="aws-properties-cloudfront-anycastiplist-tag-properties"></a>

`Key`  <a name="cfn-cloudfront-anycastiplist-tag-key"></a>
A string that contains `Tag` key.  
The string length should be between 1 and 128 characters. Valid characters include `a-z`, `A-Z`, `0-9`, space, and the special characters `_ - . : / = + @`.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`  
*Minimum*: `1`  
*Maximum*: `128`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Value`  <a name="cfn-cloudfront-anycastiplist-tag-value"></a>
A string that contains an optional `Tag` value.  
The string length should be between 0 and 256 characters. Valid characters include `a-z`, `A-Z`, `0-9`, space, and the special characters `_ - . : / = + @`.  
*Required*: No  
*Type*: String  
*Pattern*: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`  
*Minimum*: `0`  
*Maximum*: `256`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

# AWS::CloudFront::AnycastIpList Tags
<a name="aws-properties-cloudfront-anycastiplist-tags"></a>

A complex type that contains zero or more `Tag` elements.

## Syntax
<a name="aws-properties-cloudfront-anycastiplist-tags-syntax"></a>

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

### JSON
<a name="aws-properties-cloudfront-anycastiplist-tags-syntax.json"></a>

```
{
  "[Items](#cfn-cloudfront-anycastiplist-tags-items)" : [ Tag, ... ]
}
```

### YAML
<a name="aws-properties-cloudfront-anycastiplist-tags-syntax.yaml"></a>

```
  [Items](#cfn-cloudfront-anycastiplist-tags-items): 
    - Tag
```

## Properties
<a name="aws-properties-cloudfront-anycastiplist-tags-properties"></a>

`Items`  <a name="cfn-cloudfront-anycastiplist-tags-items"></a>
A complex type that contains `Tag` elements.  
*Required*: No  
*Type*: Array of [Tag](aws-properties-cloudfront-anycastiplist-tag.md)  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)