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
 
Updates the settings that specify delivery of log files. Changes to a trail do not require stopping the CloudTrail service. Use this action to designate an existing bucket for log delivery. If the existing bucket has previously been a target for CloudTrail log files, an IAM policy exists for the bucket. UpdateTrail must be called from the region in which the trail was created; otherwise, an InvalidHomeRegionException is thrown.

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

Syntax

C#
public abstract UpdateTrailResponse UpdateTrail(
         UpdateTrailRequest request
)

Parameters

request
Type: Amazon.CloudTrail.Model.UpdateTrailRequest

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

Return Value
Type: Amazon.CloudTrail.Model.UpdateTrailResponse
The response from the UpdateTrail 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.
InvalidHomeRegionException This exception is thrown when an operation is called on a trail from a region other than the region in which the trail was created.
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.
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.
TrailNotFoundException This exception is thrown when the trail with the given name is not found.
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