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

UpdateAnycastIpList

Updates an Anycast static IP list.

Request Syntax


PUT /2020-05-31/anycast-ip-list/Id HTTP/1.1
If-Match: IfMatch
<?xml version="1.0" encoding="UTF-8"?>
<UpdateAnycastIpListRequest xmlns="http://cloudfront.amazonaws.com/doc/2020-05-31/">
   <IpAddressType>string</IpAddressType>
</UpdateAnycastIpListRequest>

URI Request Parameters

The request uses the following URI parameters.

Id

The ID of the Anycast static IP list.

Required: Yes

If-Match

The current version (ETag value) of the Anycast static IP list that you are updating.

Required: Yes

Request Body

The request accepts the following data in XML format.

UpdateAnycastIpListRequest

Root level tag for the UpdateAnycastIpListRequest 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

Response Syntax


HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<AnycastIpList>
   <AnycastIps>
      <AnycastIp>string</AnycastIp>
   </AnycastIps>
   <Arn>string</Arn>
   <Id>string</Id>
   <IpAddressType>string</IpAddressType>
   <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 200 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

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

EntityNotFound

The entity was not found.

HTTP Status Code: 404

InvalidArgument

An argument is invalid.

HTTP Status Code: 400

InvalidIfMatchVersion

The If-Match version is missing or not valid.

HTTP Status Code: 400

PreconditionFailed

The precondition in one or more of the request fields evaluated to false.

HTTP Status Code: 412

UnsupportedOperation

This operation is not supported in this AWS Region.

HTTP Status Code: 400