Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

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/">
   <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

IpCount

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

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

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

HTTP Status Code: 400