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.

See also: AWS API Documentation

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