DeleteBucketWebsite
Note
This operation is not supported for directory buckets.
This action removes the website configuration for a bucket. Amazon S3 returns a 200
OK
response upon successfully deleting a website configuration on the specified
bucket. You will get a 200 OK
response if the website configuration you are
trying to delete does not exist on the bucket. Amazon S3 returns a 404
response if
the bucket specified in the request does not exist.
This DELETE action requires the S3:DeleteBucketWebsite
permission. By
default, only the bucket owner can delete the website configuration attached to a bucket.
However, bucket owners can grant other users permission to delete the website configuration
by writing a bucket policy granting them the S3:DeleteBucketWebsite
permission.
For more information about hosting websites, see Hosting Websites on Amazon S3.
The following operations are related to DeleteBucketWebsite
:
Request Syntax
DELETE /?website 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
-
The bucket name for which you want to remove the website configuration.
Required: Yes
- x-amz-expected-bucket-owner
-
The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, 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 website configuration on the specified bucket.
DELETE ?website HTTP/1.1 Host: example-bucket.s3.<Region>.amazonaws.com Date: Thu, 27 Jan 2011 12:00:00 GMT Authorization: signatureValue
Sample Response
This example illustrates one usage of DeleteBucketWebsite.
HTTP/1.1 204 No Content x-amz-id-2: aws-s3integ-s3ws-31008.sea31.amazon.com x-amz-request-id: AF1DD829D3B49707 Date: Thu, 03 Feb 2011 22:10:26 GMT Server: AmazonS3
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: