DeleteBucket
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.
The following operations are related to DeleteBucket:
Request Syntax
DELETE / HTTP/1.1
Host: Bucket.s3.amazonaws.com
x-amz-expected-bucket-owner: ExpectedBucketOwner
URI Request Parameters
The request uses the following URI parameters.
- Bucket
-
Specifies the bucket being deleted.
Required: Yes
- x-amz-expected-bucket-owner
-
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).
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 204
Response Elements
If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.
Examples
Sample Request
This request deletes the bucket named quotes.
DELETE / HTTP/1.1 Host: quotes.s3.<Region>.amazonaws.com Date: Wed, 01 Mar 2006 12:00:00 GMT Authorization: authorization string
Sample Response
HTTP/1.1 204 No Content x-amz-id-2: JuKZqmXuiwFeDQxhD7M8KtsKobSzWA1QEjLbTMTagkKdBX2z7Il/jGhDeJ3j6s80 x-amz-request-id: 32FE2CEB32F5EE25 Date: Wed, 01 Mar 2006 12:00:00 GMT Connection: close Server: AmazonS3
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: