CloudTrail / Client / list_import_failures

list_import_failures¶

CloudTrail.Client.list_import_failures(**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 a list of failures for the specified import.

Request Syntax

response = client.list_import_failures(
    ImportId='string',
    MaxResults=123,
    NextToken='string'
)

Parameters:

ImportId (string) –
[REQUIRED]

The ID of the import.
MaxResults (integer) – The maximum number of failures to display on a single page.
NextToken (string) – A token you can use to get the next page of import failures.

Return type:

dict

Returns:

Response Syntax

{
    'Failures': [
        {
            'Location': 'string',
            'Status': 'FAILED'|'RETRY'|'SUCCEEDED',
            'ErrorType': 'string',
            'ErrorMessage': 'string',
            'LastUpdatedTime': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) –
- Failures (list) –
  
  Contains information about the import failures.
  - (dict) –
    
    Provides information about an import failure.
    - Location (string) –
      
      The location of the failure in the S3 bucket.
    - Status (string) –
      
      The status of the import.
    - ErrorType (string) –
      
      The type of import error.
    - ErrorMessage (string) –
      
      Provides the reason the import failed.
    - LastUpdatedTime (datetime) –
      
      When the import was last updated.
- NextToken (string) –
  
  A token you can use to get the next page of results.

Exceptions

CloudTrail.Client.exceptions.InvalidNextTokenException
CloudTrail.Client.exceptions.OperationNotPermittedException
CloudTrail.Client.exceptions.UnsupportedOperationException
CloudTrail.Client.exceptions.InvalidParameterException