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