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.

Note:

For .NET Core 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
CloudTrailAccessNotEnabledException This exception is thrown when trusted access has not been enabled between AWS CloudTrail and AWS Organizations. For more information, see Enabling Trusted Access with Other AWS Services and Prepare For Creating a Trail For Your Organization.
CloudWatchLogsDeliveryUnavailableException Cannot set a CloudWatch Logs delivery for this region.
InsufficientDependencyServiceAccessPermissionException This exception is thrown when the IAM user or role that is used to create the organization trail is lacking one or more required permissions for creating an organization trail in a required service. For more information, see Prepare For Creating a Trail For Your Organization.
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.
InvalidTagParameterException This exception is thrown when the specified tag key or values are not valid. It can also occur if there are duplicate tags or too many tags on the resource.
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 no longer in use.
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.
NotOrganizationMasterAccountException This exception is thrown when the AWS account making the request to create or update an organization trail is not the master account for an organization in AWS Organizations. For more information, see Prepare For Creating a Trail For Your Organization.
OperationNotPermittedException This exception is thrown when the requested operation is not permitted.
OrganizationNotInAllFeaturesModeException This exception is thrown when AWS Organizations is not configured to support all features. All features must be enabled in AWS Organization to support creating an organization trail. For more information, see Prepare For Creating a Trail For Your Organization.
OrganizationsNotInUseException This exception is thrown when the request is made from an AWS account that is not a member of an organization. To make this request, sign in using the credentials of an account that belongs to an organization.
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 no longer in use.
UnsupportedOperationException This exception is thrown when the requested operation is not supported.

Version Information

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

See Also