:doc:`QuickSight <../../quicksight>` / Client / create_vpc_connection

*********************
create_vpc_connection
*********************



.. py:method:: QuickSight.Client.create_vpc_connection(**kwargs)

  

  Creates a new VPC connection.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/quicksight-2018-04-01/CreateVPCConnection>`_  


  **Request Syntax**
  ::

    response = client.create_vpc_connection(
        AwsAccountId='string',
        VPCConnectionId='string',
        Name='string',
        SubnetIds=[
            'string',
        ],
        SecurityGroupIds=[
            'string',
        ],
        DnsResolvers=[
            'string',
        ],
        RoleArn='string',
        Tags=[
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    )
    
  :type AwsAccountId: string
  :param AwsAccountId: **[REQUIRED]** 

    The Amazon Web Services account ID of the account where you want to create a new VPC connection.

    

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

    The ID of the VPC connection that you're creating. This ID is a unique identifier for each Amazon Web Services Region in an Amazon Web Services account.

    

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

    The display name for the VPC connection.

    

  
  :type SubnetIds: list
  :param SubnetIds: **[REQUIRED]** 

    A list of subnet IDs for the VPC connection.

    

  
    - *(string) --* 

    

  :type SecurityGroupIds: list
  :param SecurityGroupIds: **[REQUIRED]** 

    A list of security group IDs for the VPC connection.

    

  
    - *(string) --* 

    

  :type DnsResolvers: list
  :param DnsResolvers: 

    A list of IP addresses of DNS resolver endpoints for the VPC connection.

    

  
    - *(string) --* 

    

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

    The IAM role to associate with the VPC connection.

    

  
  :type Tags: list
  :param Tags: 

    A map of the key-value pairs for the resource tag or tags assigned to the VPC connection.

    

  
    - *(dict) --* 

      The key or keys of the key-value pairs for the resource tag or tags assigned to the resource.

      

    
      - **Key** *(string) --* **[REQUIRED]** 

        Tag key.

        

      
      - **Value** *(string) --* **[REQUIRED]** 

        Tag value.

        

      
    

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

    
    ::

      {
          'Arn': 'string',
          'VPCConnectionId': 'string',
          'CreationStatus': 'CREATION_IN_PROGRESS'|'CREATION_SUCCESSFUL'|'CREATION_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_SUCCESSFUL'|'UPDATE_FAILED'|'DELETION_IN_PROGRESS'|'DELETION_FAILED'|'DELETED',
          'AvailabilityStatus': 'AVAILABLE'|'UNAVAILABLE'|'PARTIALLY_AVAILABLE',
          'RequestId': 'string',
          'Status': 123
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

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

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

        
      

      - **VPCConnectionId** *(string) --* 

        The ID for the VPC connection that you're creating. This ID is unique per Amazon Web Services Region for each Amazon Web Services account.

        
      

      - **CreationStatus** *(string) --* 

        The status of the creation of the VPC connection.

        
      

      - **AvailabilityStatus** *(string) --* 

        The availability status of the VPC connection.

        
      

      - **RequestId** *(string) --* 

        The Amazon Web Services request ID for this operation.

        
      

      - **Status** *(integer) --* 

        The HTTP status of the request.

        
  
  **Exceptions**
  
  *   :py:class:`QuickSight.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`QuickSight.Client.exceptions.ConflictException`

  
  *   :py:class:`QuickSight.Client.exceptions.InvalidParameterValueException`

  
  *   :py:class:`QuickSight.Client.exceptions.LimitExceededException`

  
  *   :py:class:`QuickSight.Client.exceptions.ResourceExistsException`

  
  *   :py:class:`QuickSight.Client.exceptions.ThrottlingException`

  
  *   :py:class:`QuickSight.Client.exceptions.UnsupportedUserEditionException`

  
  *   :py:class:`QuickSight.Client.exceptions.InternalFailureException`

  