CloudTrail / Client / list_imports

list_imports#

CloudTrail.Client.list_imports(**kwargs)#

Returns information on all imports, or a select set of imports by ImportStatus or Destination.

Request Syntax

response = client.list_imports(
    MaxResults=123,
    Destination='string',
    ImportStatus='INITIALIZING'|'IN_PROGRESS'|'FAILED'|'STOPPED'|'COMPLETED',
    NextToken='string'
)

Parameters:

MaxResults (integer) – The maximum number of imports to display on a single page.
Destination (string) – The ARN of the destination event data store.
ImportStatus (string) – The status of the import.
NextToken (string) – A token you can use to get the next page of import results.

Return type:

dict

Returns:

Response Syntax

{
    'Imports': [
        {
            'ImportId': 'string',
            'ImportStatus': 'INITIALIZING'|'IN_PROGRESS'|'FAILED'|'STOPPED'|'COMPLETED',
            'Destinations': [
                'string',
            ],
            'CreatedTimestamp': datetime(2015, 1, 1),
            'UpdatedTimestamp': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) –
- Imports (list) –
  
  The list of returned imports.
  - (dict) –
    
    Contains information about an import that was returned by a lookup request.
    - ImportId (string) –
      
      The ID of the import.
    - ImportStatus (string) –
      
      The status of the import.
    - Destinations (list) –
      
      The ARN of the destination event data store.
      - (string) –
    - CreatedTimestamp (datetime) –
      
      The timestamp of the import’s creation.
    - UpdatedTimestamp (datetime) –
      
      The timestamp of the import’s last update.
- NextToken (string) –
  
  A token you can use to get the next page of import results.

Exceptions

CloudTrail.Client.exceptions.EventDataStoreARNInvalidException
CloudTrail.Client.exceptions.InvalidNextTokenException
CloudTrail.Client.exceptions.InvalidParameterException
CloudTrail.Client.exceptions.OperationNotPermittedException
CloudTrail.Client.exceptions.UnsupportedOperationException