AWS SDK Version 2 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.

.NET Framework 4.5
 
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.

Namespace: Amazon.CloudTrail
Assembly: AWSSDK.dll
Version: (assembly version)

Syntax

C#
public abstract CreateTrailResponse CreateTrail(
         CreateTrailRequest request
)

Parameters

request
Type: Amazon.CloudTrail.Model.CreateTrailRequest

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

Return Value
Type: Amazon.CloudTrail.Model.CreateTrailResponse
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 numberBe between 3 and 128 charactersHave 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)
KmsKeyDisabledException This exception is thrown when the KMS key is disabled.
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