Skip to content

Delete Trail

cloudtrail_delete_trail R Documentation

Deletes a trail

Description

Deletes a trail. This operation must be called from the Region in which the trail was created. delete_trail cannot be called on the shadow trails (replicated trails in other Regions) of a trail that is enabled in all Regions.

While deleting a CloudTrail trail is an irreversible action, CloudTrail does not delete log files in the Amazon S3 bucket for that trail, the Amazon S3 bucket itself, or the CloudWatchlog group to which the trail delivers events. Deleting a multi-Region trail will stop logging of events in all Amazon Web Services Regions enabled in your Amazon Web Services account. Deleting a single-Region trail will stop logging of events in that Region only. It will not stop logging of events in other Regions even if the trails in those other Regions have identical names to the deleted trail.

For information about account closure and deletion of CloudTrail trails, see https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-account-closure.html.

Usage

cloudtrail_delete_trail(Name)

Arguments

Name

[required] Specifies the name or the CloudTrail ARN of the trail to be deleted. The following is the format of a trail ARN. arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

Value

An empty list.

Request syntax

svc$delete_trail(
  Name = "string"
)