Smaws_Client_CloudTrail.StartImport
val request :
Smaws_Lib.Context.t ->
start_import_request ->
(start_import_response,
[> Smaws_Lib.Protocols.AwsJson.error
| `AccountHasOngoingImportException of account_has_ongoing_import_exception
| `EventDataStoreARNInvalidException of
event_data_store_arn_invalid_exception
| `EventDataStoreNotFoundException of event_data_store_not_found_exception
| `ImportNotFoundException of import_not_found_exception
| `InactiveEventDataStoreException of inactive_event_data_store_exception
| `InsufficientEncryptionPolicyException of
insufficient_encryption_policy_exception
| `InvalidEventDataStoreCategoryException of
invalid_event_data_store_category_exception
| `InvalidEventDataStoreStatusException of
invalid_event_data_store_status_exception
| `InvalidImportSourceException of invalid_import_source_exception
| `InvalidParameterException of invalid_parameter_exception
| `OperationNotPermittedException of operation_not_permitted_exception
| `UnsupportedOperationException of unsupported_operation_exception ])
Stdlib.result
Starts an import of logged trail events from a source S3 bucket to a destination event data store. By default, CloudTrail only imports events contained in the S3 bucket's CloudTrail
prefix and the prefixes inside the CloudTrail
prefix, and does not check prefixes for other Amazon Web Services services. If you want to import CloudTrail events contained in another prefix, you must include the prefix in the S3LocationUri
. For more considerations about importing trail events, see Considerations for copying trail events in the CloudTrail User Guide.
When you start a new import, the Destinations
and ImportSource
parameters are required. Before starting a new import, disable any access control lists (ACLs) attached to the source S3 bucket. For more information about disabling ACLs, see Controlling ownership of objects and disabling ACLs for your bucket.
When you retry an import, the ImportID
parameter is required.
If the destination event data store is for an organization, you must use the management account to import trail events. You cannot use the delegated administrator account for the organization.