CloudFront / Client / create_anycast_ip_list

create_anycast_ip_list#

CloudFront.Client.create_anycast_ip_list(**kwargs)#

Creates an Anycast static IP list.

See also: AWS API Documentation

Request Syntax

response = client.create_anycast_ip_list(
    Name='string',
    IpCount=123,
    Tags={
        'Items': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    }
)
Parameters:
  • Name (string) –

    [REQUIRED]

    Name of the Anycast static IP list.

  • IpCount (integer) –

    [REQUIRED]

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

  • Tags (dict) –

    A complex type that contains zero or more Tag elements.

    • Items (list) –

      A complex type that contains Tag elements.

      • (dict) –

        A complex type that contains Tag key and Tag value.

        • Key (string) – [REQUIRED]

          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 _ - . : / = + @.

        • Value (string) –

          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 _ - . : / = + @.

Return type:

dict

Returns:

Response Syntax

{
    'AnycastIpList': {
        'Id': 'string',
        'Name': 'string',
        'Status': 'string',
        'Arn': 'string',
        'AnycastIps': [
            'string',
        ],
        'IpCount': 123,
        'LastModifiedTime': datetime(2015, 1, 1)
    },
    'ETag': 'string'
}

Response Structure

  • (dict) –

    • AnycastIpList (dict) –

      A response structure that includes the version identifier (ETag) and the created AnycastIpList structure.

      • Id (string) –

        The ID of the Anycast static IP list.

      • Name (string) –

        The name of the Anycast static IP list.

      • Status (string) –

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

      • Arn (string) –

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

      • AnycastIps (list) –

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

        • (string) –

      • IpCount (integer) –

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

      • LastModifiedTime (datetime) –

        The last time the Anycast static IP list was modified.

    • ETag (string) –

      The version identifier for the current version of the Anycast static IP list.

Exceptions

  • CloudFront.Client.exceptions.AccessDenied

  • CloudFront.Client.exceptions.UnsupportedOperation

  • CloudFront.Client.exceptions.EntityAlreadyExists

  • CloudFront.Client.exceptions.InvalidTagging

  • CloudFront.Client.exceptions.InvalidArgument

  • CloudFront.Client.exceptions.EntityLimitExceeded