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

*****************
list_transactions
*****************



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

  

  Returns metadata about transactions and their status. To prevent the response from growing indefinitely, only uncommitted transactions and those available for time-travel queries are returned.

   

  This operation can help you identify uncommitted transactions or to get information about transactions.

  

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


  **Request Syntax**
  ::

    response = client.list_transactions(
        CatalogId='string',
        StatusFilter='ALL'|'COMPLETED'|'ACTIVE'|'COMMITTED'|'ABORTED',
        MaxResults=123,
        NextToken='string'
    )
    
  :type CatalogId: string
  :param CatalogId: 

    The catalog for which to list transactions. Defaults to the account ID of the caller.

    

  
  :type StatusFilter: string
  :param StatusFilter: 

    A filter indicating the status of transactions to return. Options are ALL | COMPLETED | COMMITTED | ABORTED | ACTIVE. The default is ``ALL``.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of transactions to return in a single call.

    

  
  :type NextToken: string
  :param NextToken: 

    A continuation token if this is not the first call to retrieve transactions.

    

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

    
    ::

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

    

    - *(dict) --* 
      

      - **Transactions** *(list) --* 

        A list of transactions. The record for each transaction is a ``TransactionDescription`` object.

        
        

        - *(dict) --* 

          A structure that contains information about a 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.

            
      
    
      

      - **NextToken** *(string) --* 

        A continuation token indicating whether additional data is available.

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

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

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

  