:doc:`Outposts <../../outposts>` / Client / get_connection

**************
get_connection
**************



.. py:method:: Outposts.Client.get_connection(**kwargs)

  

  .. note::

    

    Amazon Web Services uses this action to install Outpost servers.

    

   

  Gets information about the specified connection.

   

  Use CloudTrail to monitor this action or Amazon Web Services managed policy for Amazon Web Services Outposts to secure it. For more information, see `Amazon Web Services managed policies for Amazon Web Services Outposts <https://docs.aws.amazon.com/outposts/latest/userguide/security-iam-awsmanpol.html>`__ and `Logging Amazon Web Services Outposts API calls with Amazon Web Services CloudTrail <https://docs.aws.amazon.com/outposts/latest/userguide/logging-using-cloudtrail.html>`__ in the *Amazon Web Services Outposts User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/outposts-2019-12-03/GetConnection>`_  


  **Request Syntax**
  ::

    response = client.get_connection(
        ConnectionId='string'
    )
    
  :type ConnectionId: string
  :param ConnectionId: **[REQUIRED]** 

    The ID of the connection.

    

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

    
    ::

      {
          'ConnectionId': 'string',
          'ConnectionDetails': {
              'ClientPublicKey': 'string',
              'ServerPublicKey': 'string',
              'ServerEndpoint': 'string',
              'ClientTunnelAddress': 'string',
              'ServerTunnelAddress': 'string',
              'AllowedIps': [
                  'string',
              ]
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ConnectionId** *(string) --* 

        The ID of the connection.

        
      

      - **ConnectionDetails** *(dict) --* 

        Information about the connection.

        
        

        - **ClientPublicKey** *(string) --* 

          The public key of the client.

          
        

        - **ServerPublicKey** *(string) --* 

          The public key of the server.

          
        

        - **ServerEndpoint** *(string) --* 

          The endpoint for the server.

          
        

        - **ClientTunnelAddress** *(string) --* 

          The client tunnel address.

          
        

        - **ServerTunnelAddress** *(string) --* 

          The server tunnel address.

          
        

        - **AllowedIps** *(list) --* 

          The allowed IP addresses.

          
          

          - *(string) --* 
      
    
  
  **Exceptions**
  
  *   :py:class:`Outposts.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`Outposts.Client.exceptions.ValidationException`

  
  *   :py:class:`Outposts.Client.exceptions.NotFoundException`

  
  *   :py:class:`Outposts.Client.exceptions.InternalServerException`

  