imports

Creates, updates, deletes, gets or lists an imports resource.

Overview

Name	imports
Type	Resource
Id	aws.cloudtrail.imports

Fields

The following fields are returned by SELECT queries:

get_import

Name	Datatype	Description
created_timestamp	string (date-time)	The timestamp of the import's creation.
destinations	array	The ARN of the destination event data store.
end_event_time	string (date-time)	Used with StartEventTime to bound a StartImport request, and limit imported trail events to only those events logged within a specified time period.
import_id	string	The ID of the import. (pattern: <code>^[a-f0-9-]+$</code>)
import_source	object	The source S3 bucket.
import_statistics	object	Provides statistics for the import. CloudTrail does not update import statistics in real-time. Returned values for parameters such as EventsCompleted may be lower than the actual value, because CloudTrail updates statistics incrementally over the course of the import.
import_status	string	The status of the import. (INITIALIZING, IN_PROGRESS, FAILED, STOPPED, COMPLETED)
start_event_time	string (date-time)	Used with EndEventTime to bound a StartImport request, and limit imported trail events to only those events logged within a specified time period.
updated_timestamp	string (date-time)	The timestamp of when the import was updated.

list_imports

Name	Datatype	Description
created_timestamp	string (date-time)	The timestamp of the import's creation.
destinations	array	The ARN of the destination event data store.
import_id	string	The ID of the import. (pattern: <code>^[a-f0-9-]+$</code>)
import_status	string	The status of the import. (INITIALIZING, IN_PROGRESS, FAILED, STOPPED, COMPLETED)
updated_timestamp	string (date-time)	The timestamp of the import's last update.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_import	select	region		Returns information about a specific import.
list_imports	select	region		Returns information on all imports, or a select set of imports by ImportStatus or Destination.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)

SELECT examples

get_import

Returns information about a specific import.

SELECT
created_timestamp,
destinations,
end_event_time,
import_id,
import_source,
import_statistics,
import_status,
start_event_time,
updated_timestamp
FROM aws.cloudtrail.imports
WHERE region = '{{ region }}' -- required
;

list_imports

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

SELECT
created_timestamp,
destinations,
import_id,
import_status,
updated_timestamp
FROM aws.cloudtrail.imports
WHERE region = '{{ region }}' -- required
;