Creates a CIDR collection in the current Amazon Web Services account.

See also: AWS API Documentation

Request Syntax

response = client.create_cidr_collection(
  • Name (string) --


    A unique identifier for the account that can be used to reference the collection from other API calls.

  • CallerReference (string) --


    A client-specific token that allows requests to be securely retried so that the intended outcome will only occur once, retries receive a similar response, and there are no additional edge cases to handle.

Return type



Response Syntax

    'Collection': {
        'Arn': 'string',
        'Id': 'string',
        'Name': 'string',
        'Version': 123
    'Location': 'string'

Response Structure

  • (dict) --

    • Collection (dict) --

      A complex type that contains information about the CIDR collection.

      • Arn (string) --

        The ARN of the collection. Can be used to reference the collection in IAM policy or in another Amazon Web Services account.

      • Id (string) --

        The unique ID of the CIDR collection.

      • Name (string) --

        The name of a CIDR collection.

      • Version (integer) --

        A sequential counter that Route 53 sets to 1 when you create a CIDR collection and increments by 1 each time you update settings for the CIDR collection.

    • Location (string) --

      A unique URL that represents the location for the CIDR collection.


  • Route53.Client.exceptions.LimitsExceeded
  • Route53.Client.exceptions.InvalidInput
  • Route53.Client.exceptions.CidrCollectionAlreadyExistsException
  • Route53.Client.exceptions.ConcurrentModification