AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
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.
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.
For .NET Core this operation is only available in asynchronous form. Please refer to StartImportAsync.
Namespace: Amazon.CloudTrail
Assembly: AWSSDK.CloudTrail.dll
Version: 3.x.y.z
public abstract StartImportResponse StartImport( StartImportRequest request )
Container for the necessary parameters to execute the StartImport service method.
Exception | Condition |
---|---|
AccountHasOngoingImportException | This exception is thrown when you start a new import and a previous import is still in progress. |
EventDataStoreARNInvalidException | The specified event data store ARN is not valid or does not map to an event data store in your account. |
EventDataStoreNotFoundException | The specified event data store was not found. |
ImportNotFoundException | The specified import was not found. |
InactiveEventDataStoreException | The event data store is inactive. |
InsufficientEncryptionPolicyException | This exception is thrown when the policy on the S3 bucket or KMS key does not have sufficient permissions for the operation. |
InvalidEventDataStoreCategoryException | This exception is thrown when event categories of specified event data stores are not valid. |
InvalidEventDataStoreStatusException | The event data store is not in a status that supports the operation. |
InvalidImportSourceException | This exception is thrown when the provided source S3 bucket is not valid for import. |
InvalidParameterException | The request includes a parameter that is not valid. |
OperationNotPermittedException | This exception is thrown when the requested operation is not permitted. |
UnsupportedOperationException | This exception is thrown when the requested operation is not supported. |
.NET Framework:
Supported in: 4.5, 4.0, 3.5