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