Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

list_imports

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