DELETE Bucket¶
You can use this operation to delete the buckets specified by a user.
Only the bucket owner and users who are granted the permission to delete buckets can delete buckets. Only an empty bucket can be deleted. If a bucket has an object or a multipart task, the bucket is not empty. You can determine whether a bucket is empty by listing objects and multipart upload tasks in the bucket.
Note
If a 5xx error is returned from the server or the request times out during bucket deletion, the system takes about 10 minutes to make bucket information consistent. During the process, bucket information is inaccurate.
Request Syntax¶
DELETE / HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: date
Authorization: authorization
Request Parameters¶
This request involves no parameters.
Request Headers¶
This request uses common headers. For details about common request headers, see section Common Request Headers.
Request Elements¶
This request involves no elements.
Response Syntax¶
HTTP/1.1 status_code
Server: Server Name
x-amz-request-id: request id
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: id
Date: date
Response Headers¶
This response uses common headers. For details about common response headers, see section Common Response Headers.
Response Elements¶
This response involves no elements.
Error Responses¶
No special errors are returned. For details about error responses, see Table 1.
Sample Request¶
DELETE / HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Sat, 03 Dec 2011 07:07:35 +0000
Authorization: AWS BF6C09F302931425E9A7:lgEeRg8WE0XOpjurUSX26QDIZRw=
Sample Response¶
HTTP/1.1 204 No Content
Server: OBS
x-amz-request-id: 001B21A61C6C0000013402BFDBA85281
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: MDAxQjIxQTYxQzZDMDAwMDAxMzQwMkJGREJBODUyODFBQUFBQUFBQWJiYmJiYmJi
Date: Sat, 03 Dec 2011 07:07:38 GMT