Skip to content

get_import

Operation

get_import

get_import(request: GetImportInput | GetImportInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[GetImportInputDict]) -> GetImportOutput
Warning

CloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see CloudTrail Lake availability change.

Returns information about a specific import.

Parameters:

Name Type Description Default
request GetImportInput | GetImportInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[GetImportInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
GetImportOutput

An instance of GetImportOutput.

get_import async

get_import(request: GetImportInput | GetImportInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[GetImportInputDict]) -> GetImportOutput
Warning

CloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see CloudTrail Lake availability change.

Returns information about a specific import.

Parameters:

Name Type Description Default
request GetImportInput | GetImportInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[GetImportInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
GetImportOutput

An instance of GetImportOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

GetImportInputDict

Bases: TypedDict

Dictionary form of GetImportInput.

Attributes

import_id instance-attribute
import_id: Required[str]

The ID for the import.

GetImportInput dataclass

Bases: _SerdeShape

Dataclass for GetImportInput structure.

Attributes

import_id class-attribute instance-attribute
import_id: str | None = ...

The ID for the import.

Output

GetImportOutput dataclass

Bases: _SerdeShape

Dataclass for GetImportOutput structure.

Attributes

created_timestamp class-attribute instance-attribute
created_timestamp: datetime | None = ...

The timestamp of the import's creation.

destinations class-attribute instance-attribute
destinations: list[str] | None = ...

The ARN of the destination event data store.

end_event_time class-attribute instance-attribute
end_event_time: datetime | None = ...

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 class-attribute instance-attribute
import_id: str | None = ...

The ID of the import.

import_source class-attribute instance-attribute
import_source: ImportSource | None = ...

The source S3 bucket.

import_statistics class-attribute instance-attribute
import_statistics: ImportStatistics | None = ...

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 class-attribute instance-attribute
import_status: str | None = ...

The status of the import.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

start_event_time class-attribute instance-attribute
start_event_time: datetime | None = ...

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 class-attribute instance-attribute
updated_timestamp: datetime | None = ...

The timestamp of when the import was updated.