delete_bucket

S3.Client.delete_bucket(**kwargs)

Deletes the S3 bucket. All objects (including all object versions and delete markers) in the bucket must be deleted before the bucket itself can be deleted.

Related Resources

• CreateBucket
• DeleteObject

See also: AWS API Documentation

Request Syntax

response = client.delete_bucket(
    Bucket='string',
    ExpectedBucketOwner='string'
)

Parameters

• Bucket (string) --

  [REQUIRED]

  Specifies the bucket being deleted.

• ExpectedBucketOwner (string) -- The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with the HTTP status code 403 Forbidden (access denied).

Returns

None

Examples

The following example deletes the specified bucket.

response = client.delete_bucket(
    Bucket='forrandall2',
)

print(response)

Expected Output:

{
    'ResponseMetadata': {
        '...': '...',
    },
}