:doc:`Route53 <../../route53>` / Client / create_cidr_collection

**********************
create_cidr_collection
**********************



.. py:method:: Route53.Client.create_cidr_collection(**kwargs)

  

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

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateCidrCollection>`_  


  **Request Syntax**
  ::

    response = client.create_cidr_collection(
        Name='string',
        CallerReference='string'
    )
    
  :type Name: string
  :param Name: **[REQUIRED]** 

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

    

  
  :type CallerReference: string
  :param CallerReference: **[REQUIRED]** 

    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.

    

  
  
  :rtype: dict
  :returns: 
    
    **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.

        
  
  **Exceptions**
  
  *   :py:class:`Route53.Client.exceptions.LimitsExceeded`

  
  *   :py:class:`Route53.Client.exceptions.InvalidInput`

  
  *   :py:class:`Route53.Client.exceptions.CidrCollectionAlreadyExistsException`

  
  *   :py:class:`Route53.Client.exceptions.ConcurrentModification`

  