delete_trail

delete_trail(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response = client.delete_trail(
    Name='string'
)
Parameters
Name (string) --

[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

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

    Returns the objects or data listed below if successful. Otherwise, returns an error.

Exceptions

  • CloudTrail.Client.exceptions.TrailNotFoundException
  • CloudTrail.Client.exceptions.InvalidTrailNameException
  • CloudTrail.Client.exceptions.CloudTrailARNInvalidException
  • CloudTrail.Client.exceptions.ConflictException
  • CloudTrail.Client.exceptions.InvalidHomeRegionException
  • CloudTrail.Client.exceptions.UnsupportedOperationException
  • CloudTrail.Client.exceptions.OperationNotPermittedException
  • CloudTrail.Client.exceptions.NotOrganizationMasterAccountException
  • CloudTrail.Client.exceptions.NoManagementAccountSLRExistsException
  • CloudTrail.Client.exceptions.InsufficientDependencyServiceAccessPermissionException