CreateAnycastIpList - Amazon CloudFront

CreateAnycastIpList

Creates an Anycast static IP list.

Request Syntax

POST /2020-05-31/anycast-ip-list HTTP/1.1 <?xml version="1.0" encoding="UTF-8"?> <CreateAnycastIpListRequest xmlns="http://cloudfront.amazonaws.com/doc/2020-05-31/"> <IpAddressType>string</IpAddressType> <IpamCidrConfigs> <IpamCidrConfig> <AnycastIp>string</AnycastIp> <Cidr>string</Cidr> <IpamPoolArn>string</IpamPoolArn> <Status>string</Status> </IpamCidrConfig> </IpamCidrConfigs> <IpCount>integer</IpCount> <Name>string</Name> <Tags> <Items> <Tag> <Key>string</Key> <Value>string</Value> </Tag> </Items> </Tags> </CreateAnycastIpListRequest>

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in XML format.

CreateAnycastIpListRequest

Root level tag for the CreateAnycastIpListRequest parameters.

Required: Yes

IpAddressType

The IP address type for the Anycast static IP list. You can specify one of the following options:

  • ipv4 only

  • ipv6 only

  • dualstack - Allocate a list of both IPv4 and IPv6 addresses

Type: String

Valid Values: ipv4 | ipv6 | dualstack

Required: No

IpamCidrConfigs

A list of IPAM CIDR configurations that specify the IP address ranges and IPAM pool settings for creating the Anycast static IP list.

Type: Array of IpamCidrConfig objects

Required: No

IpCount

The number of static IP addresses that are allocated to the Anycast static IP list. Valid values: 21 or 3.

Type: Integer

Required: Yes

Name

Name of the Anycast static IP list.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [a-zA-Z0-9-_]{1,64}

Required: Yes

Tags

A complex type that contains zero or more Tag elements.

Type: Tags object

Required: No

Response Syntax

HTTP/1.1 202 <?xml version="1.0" encoding="UTF-8"?> <AnycastIpList> <AnycastIps> <AnycastIp>string</AnycastIp> </AnycastIps> <Arn>string</Arn> <Id>string</Id> <IpAddressType>string</IpAddressType> <IpamConfig> <IpamCidrConfigs> <IpamCidrConfig> <AnycastIp>string</AnycastIp> <Cidr>string</Cidr> <IpamPoolArn>string</IpamPoolArn> <Status>string</Status> </IpamCidrConfig> </IpamCidrConfigs> <Quantity>integer</Quantity> </IpamConfig> <IpCount>integer</IpCount> <LastModifiedTime>timestamp</LastModifiedTime> <Name>string</Name> <Status>string</Status> </AnycastIpList>

Response Elements

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in XML format by the service.

AnycastIpList

Root level tag for the AnycastIpList parameters.

Required: Yes

AnycastIps

The static IP addresses that are allocated to the Anycast static IP list.

Type: Array of strings

Arn

The Amazon Resource Name (ARN) of the Anycast static IP list.

Type: String

Id

The ID of the Anycast static IP list.

Type: String

IpAddressType

The IP address type for the Anycast static IP list.

Type: String

Valid Values: ipv4 | ipv6 | dualstack

IpamConfig

The IPAM configuration for the Anycast static IP list, that contains the quantity and list of IPAM CIDR configurations.

Type: IpamConfig object

IpCount

The number of IP addresses in the Anycast static IP list.

Type: Integer

LastModifiedTime

The last time the Anycast static IP list was modified.

Type: Timestamp

Name

The name of the Anycast static IP list.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [a-zA-Z0-9-_]{1,64}

Status

The status of the Anycast static IP list. Valid values: Deployed, Deploying, or Failed.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDenied

Access denied.

HTTP Status Code: 403

EntityAlreadyExists

The entity already exists. You must provide a unique entity.

HTTP Status Code: 409

EntityLimitExceeded

The entity limit has been exceeded.

HTTP Status Code: 400

InvalidArgument

An argument is invalid.

HTTP Status Code: 400

InvalidTagging

The tagging specified is not valid.

HTTP Status Code: 400

UnsupportedOperation

This operation is not supported in this AWS Region.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: