CloudTrail / Client / get_import

get_import¶

CloudTrail.Client.get_import(**kwargs)¶

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.

Request Syntax

response = client.get_import(
    ImportId='string'
)

Parameters:

ImportId (string) –

[REQUIRED]

The ID for the import.

Return type:

dict

Returns:

Response Syntax

{
    'ImportId': 'string',
    'Destinations': [
        'string',
    ],
    'ImportSource': {
        'S3': {
            'S3LocationUri': 'string',
            'S3BucketRegion': 'string',
            'S3BucketAccessRoleArn': 'string'
        }
    },
    'StartEventTime': datetime(2015, 1, 1),
    'EndEventTime': datetime(2015, 1, 1),
    'ImportStatus': 'INITIALIZING'|'IN_PROGRESS'|'FAILED'|'STOPPED'|'COMPLETED',
    'CreatedTimestamp': datetime(2015, 1, 1),
    'UpdatedTimestamp': datetime(2015, 1, 1),
    'ImportStatistics': {
        'PrefixesFound': 123,
        'PrefixesCompleted': 123,
        'FilesCompleted': 123,
        'EventsCompleted': 123,
        'FailedEntries': 123
    }
}

Response Structure

(dict) –
- ImportId (string) –
  
  The ID of the import.
- Destinations (list) –
  
  The ARN of the destination event data store.
  - (string) –
- ImportSource (dict) –
  
  The source S3 bucket.
  - S3 (dict) –
    
    The source S3 bucket.
    - S3LocationUri (string) –
      
      The URI for the source S3 bucket.
    - S3BucketRegion (string) –
      
      The Region associated with the source S3 bucket.
    - S3BucketAccessRoleArn (string) –
      
      The IAM ARN role used to access the source S3 bucket.
- StartEventTime (datetime) –
  
  Used with EndEventTime to bound a StartImport request, and limit imported trail events to only those events logged within a specified time period.
- EndEventTime (datetime) –
  
  Used with StartEventTime to bound a StartImport request, and limit imported trail events to only those events logged within a specified time period.
- ImportStatus (string) –
  
  The status of the import.
- CreatedTimestamp (datetime) –
  
  The timestamp of the import’s creation.
- UpdatedTimestamp (datetime) –
  
  The timestamp of when the import was updated.
- ImportStatistics (dict) –
  
  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.
  - PrefixesFound (integer) –
    
    The number of S3 prefixes found for the import.
  - PrefixesCompleted (integer) –
    
    The number of S3 prefixes that completed import.
  - FilesCompleted (integer) –
    
    The number of log files that completed import.
  - EventsCompleted (integer) –
    
    The number of trail events imported into the event data store.
  - FailedEntries (integer) –
    
    The number of failed entries.