AWS SDK Version 3 for .NET
API Reference

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.

Creates a trail that specifies the settings for delivery of log data to an Amazon S3 bucket. A maximum of five trails can exist in a region, irrespective of the region in which they were created.

Note:

For PCL this operation is only available in asynchronous form. Please refer to CreateTrailAsync.

Namespace: Amazon.CloudTrail
Assembly: AWSSDK.CloudTrail.dll
Version: 3.x.y.z

Syntax

C#
public virtual CreateTrailResponse CreateTrail(
         CreateTrailRequest request
)
Parameters
request
Type: Amazon.CloudTrail.Model.CreateTrailRequest

Container for the necessary parameters to execute the CreateTrail service method.

Return Value
The response from the CreateTrail service method, as returned by CloudTrail.

Exceptions

ExceptionCondition
CloudWatchLogsDeliveryUnavailableException Cannot set a CloudWatch Logs delivery for this region.
InsufficientEncryptionPolicyException This exception is thrown when the policy on the S3 bucket or KMS key is not sufficient.
InsufficientS3BucketPolicyException This exception is thrown when the policy on the S3 bucket is not sufficient.
InsufficientSnsTopicPolicyException This exception is thrown when the policy on the SNS topic is not sufficient.
InvalidCloudWatchLogsLogGroupArnException This exception is thrown when the provided CloudWatch log group is not valid.
InvalidCloudWatchLogsRoleArnException This exception is thrown when the provided role is not valid.
InvalidKmsKeyIdException This exception is thrown when the KMS key ARN is invalid.
InvalidParameterCombinationException This exception is thrown when the combination of parameters provided is not valid.
InvalidS3BucketNameException This exception is thrown when the provided S3 bucket name is not valid.
InvalidS3PrefixException This exception is thrown when the provided S3 prefix is not valid.
InvalidSnsTopicNameException This exception is thrown when the provided SNS topic name is not valid.
InvalidTrailNameException This exception is thrown when the provided trail name is not valid. Trail names must meet the following requirements: Contain only ASCII letters (a-z, A-Z), numbers (0-9), periods (.), underscores (_), or dashes (-) Start with a letter or number, and end with a letter or number Be between 3 and 128 characters Have no adjacent periods, underscores or dashes. Names like my-_namespace and my--namespace are invalid. Not be in IP address format (for example, 192.168.5.4)
KmsException This exception is thrown when there is an issue with the specified KMS key and the trail can’t be updated.
KmsKeyDisabledException This exception is deprecated.
KmsKeyNotFoundException This exception is thrown when the KMS key does not exist, or when the S3 bucket and the KMS key are not in the same region.
MaximumNumberOfTrailsExceededException This exception is thrown when the maximum number of trails is reached.
OperationNotPermittedException This exception is thrown when the requested operation is not permitted.
S3BucketDoesNotExistException This exception is thrown when the specified S3 bucket does not exist.
TrailAlreadyExistsException This exception is thrown when the specified trail already exists.
TrailNotProvidedException This exception is deprecated.
UnsupportedOperationException This exception is thrown when the requested operation is not supported.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also