:doc:`DirectConnect <../../directconnect>` / Client / describe_loa

************
describe_loa
************



.. py:method:: DirectConnect.Client.describe_loa(**kwargs)

  

  Gets the LOA-CFA for a connection, interconnect, or link aggregation group (LAG).

   

  The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing your cross connect to Amazon Web Services at the colocation facility. For more information, see `Requesting Cross Connects at Direct Connect Locations <https://docs.aws.amazon.com/directconnect/latest/UserGuide/Colocation.html>`__ in the *Direct Connect User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeLoa>`_  


  **Request Syntax**
  ::

    response = client.describe_loa(
        connectionId='string',
        providerName='string',
        loaContentType='application/pdf'
    )
    
  :type connectionId: string
  :param connectionId: **[REQUIRED]** 

    The ID of a connection, LAG, or interconnect.

    

  
  :type providerName: string
  :param providerName: 

    The name of the service provider who establishes connectivity on your behalf. If you specify this parameter, the LOA-CFA lists the provider name alongside your company name as the requester of the cross connect.

    

  
  :type loaContentType: string
  :param loaContentType: 

    The standard media type for the LOA-CFA document. The only supported value is application/pdf.

    

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

    
    ::

      {
          'loaContent': b'bytes',
          'loaContentType': 'application/pdf'
      }
      
    **Response Structure**

    

    - *(dict) --* 

      Information about a Letter of Authorization - Connecting Facility Assignment (LOA-CFA) for a connection.

      
      

      - **loaContent** *(bytes) --* 

        The binary contents of the LOA-CFA document.

        
      

      - **loaContentType** *(string) --* 

        The standard media type for the LOA-CFA document. The only supported value is application/pdf.

        
  
  **Exceptions**
  
  *   :py:class:`DirectConnect.Client.exceptions.DirectConnectServerException`

  
  *   :py:class:`DirectConnect.Client.exceptions.DirectConnectClientException`

  