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.

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