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.

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.

Note:

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

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

Syntax

C#
public virtual UpdateTrailResponse UpdateTrail(
         UpdateTrailRequest request
)
Parameters
request
Type: Amazon.CloudTrail.Model.UpdateTrailRequest

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

Return Value
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 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.
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

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