:doc:`LakeFormation <../../lakeformation>` / Client / describe_transaction

********************
describe_transaction
********************



.. py:method:: LakeFormation.Client.describe_transaction(**kwargs)

  

  Returns the details of a single transaction.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/DescribeTransaction>`_  


  **Request Syntax**
  ::

    response = client.describe_transaction(
        TransactionId='string'
    )
    
  :type TransactionId: string
  :param TransactionId: **[REQUIRED]** 

    The transaction for which to return status.

    

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

    
    ::

      {
          'TransactionDescription': {
              'TransactionId': 'string',
              'TransactionStatus': 'ACTIVE'|'COMMITTED'|'ABORTED'|'COMMIT_IN_PROGRESS',
              'TransactionStartTime': datetime(2015, 1, 1),
              'TransactionEndTime': datetime(2015, 1, 1)
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **TransactionDescription** *(dict) --* 

        Returns a ``TransactionDescription`` object containing information about the transaction.

        
        

        - **TransactionId** *(string) --* 

          The ID of the transaction.

          
        

        - **TransactionStatus** *(string) --* 

          A status of ACTIVE, COMMITTED, or ABORTED.

          
        

        - **TransactionStartTime** *(datetime) --* 

          The time when the transaction started.

          
        

        - **TransactionEndTime** *(datetime) --* 

          The time when the transaction committed or aborted, if it is not currently active.

          
    
  
  **Exceptions**
  
  *   :py:class:`LakeFormation.Client.exceptions.EntityNotFoundException`

  
  *   :py:class:`LakeFormation.Client.exceptions.InvalidInputException`

  
  *   :py:class:`LakeFormation.Client.exceptions.InternalServiceException`

  
  *   :py:class:`LakeFormation.Client.exceptions.OperationTimeoutException`

  