:doc:`CloudFront <../../cloudfront>` / Client / create_connection_group

***********************
create_connection_group
***********************



.. py:method:: CloudFront.Client.create_connection_group(**kwargs)

  

  Creates a connection group.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/CreateConnectionGroup>`_  


  **Request Syntax**
  ::

    response = client.create_connection_group(
        Name='string',
        Ipv6Enabled=True|False,
        Tags={
            'Items': [
                {
                    'Key': 'string',
                    'Value': 'string'
                },
            ]
        },
        AnycastIpListId='string',
        Enabled=True|False
    )
    
  :type Name: string
  :param Name: **[REQUIRED]** 

    The name of the connection group. Enter a friendly identifier that is unique within your Amazon Web Services account. This name can't be updated after you create the connection group.

    

  
  :type Ipv6Enabled: boolean
  :param Ipv6Enabled: 

    Enable IPv6 for the connection group. The default is ``true``. For more information, see `Enable IPv6 <https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesEnableIPv6>`__ in the *Amazon CloudFront Developer Guide*.

    

  
  :type Tags: dict
  :param Tags: 

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

          

        
      
  
  
  :type AnycastIpListId: string
  :param AnycastIpListId: 

    The ID of the Anycast static IP list.

    

  
  :type Enabled: boolean
  :param Enabled: 

    Enable the connection group.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'ConnectionGroup': {
              'Id': 'string',
              'Name': 'string',
              'Arn': 'string',
              'CreatedTime': datetime(2015, 1, 1),
              'LastModifiedTime': datetime(2015, 1, 1),
              'Tags': {
                  'Items': [
                      {
                          'Key': 'string',
                          'Value': 'string'
                      },
                  ]
              },
              'Ipv6Enabled': True|False,
              'RoutingEndpoint': 'string',
              'AnycastIpListId': 'string',
              'Status': 'string',
              'Enabled': True|False,
              'IsDefault': True|False
          },
          'ETag': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ConnectionGroup** *(dict) --* 

        The connection group that you created.

        
        

        - **Id** *(string) --* 

          The ID of the connection group.

          
        

        - **Name** *(string) --* 

          The name of the connection group.

          
        

        - **Arn** *(string) --* 

          The Amazon Resource Name (ARN) of the connection group.

          
        

        - **CreatedTime** *(datetime) --* 

          The date and time when the connection group was created.

          
        

        - **LastModifiedTime** *(datetime) --* 

          The date and time when the connection group was updated.

          
        

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

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

                
          
        
      
        

        - **Ipv6Enabled** *(boolean) --* 

          IPv6 is enabled for the connection group.

          
        

        - **RoutingEndpoint** *(string) --* 

          The routing endpoint (also known as the DNS name) that is assigned to the connection group, such as d111111abcdef8.cloudfront.net.

          
        

        - **AnycastIpListId** *(string) --* 

          The ID of the Anycast static IP list.

          
        

        - **Status** *(string) --* 

          The status of the connection group.

          
        

        - **Enabled** *(boolean) --* 

          Whether the connection group is enabled.

          
        

        - **IsDefault** *(boolean) --* 

          Whether the connection group is the default connection group for the distribution tenants.

          
    
      

      - **ETag** *(string) --* 

        The current version of the connection group.

        
  
  **Exceptions**
  
  *   :py:class:`CloudFront.Client.exceptions.AccessDenied`

  
  *   :py:class:`CloudFront.Client.exceptions.EntityNotFound`

  
  *   :py:class:`CloudFront.Client.exceptions.EntityAlreadyExists`

  
  *   :py:class:`CloudFront.Client.exceptions.InvalidTagging`

  
  *   :py:class:`CloudFront.Client.exceptions.EntityLimitExceeded`

  
  *   :py:class:`CloudFront.Client.exceptions.InvalidArgument`

  