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.
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