CloudTrail / Client / delete_trail

delete_trail#

CloudTrail.Client.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.

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.ThrottlingException
CloudTrail.Client.exceptions.InvalidHomeRegionException
CloudTrail.Client.exceptions.UnsupportedOperationException
CloudTrail.Client.exceptions.OperationNotPermittedException
CloudTrail.Client.exceptions.NotOrganizationMasterAccountException
CloudTrail.Client.exceptions.NoManagementAccountSLRExistsException
CloudTrail.Client.exceptions.InsufficientDependencyServiceAccessPermissionException