GetAnycastIpList - Amazon CloudFront

GetAnycastIpList

Gets an Anycast static IP list.

Request Syntax

GET /2020-05-31/anycast-ip-list/Id HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

Id

The ID of the Anycast static IP list.

Required: Yes

Request Body

The request does not have a request body.

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

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

UnsupportedOperation

This operation is not supported in this 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: