Deleting Buckets
To delete buckets, use the DELETE /pools/default/buckets/[bucket-name] HTTP method and URI.
Description
Bucket deletion is a synchronous operation. When a cluster has multiple servers, some servers might not be able to delete the bucket within the standard 30 second timeout period.
-
If the bucket is deleted on all servers within the standard timeout of 30 seconds, a
200response code is returned. -
If the bucket is not deleted on all servers within the 30 second timeout, a
500error code is returned. -
If the bucket is not deleted on all servers and another request is made to delete the bucket, a
404error code is returned. -
If the bucket is not deleted on all servers and a request is made to crate a new bucket with the same name, an error might be returned indicating that the bucket is still being deleted.
| This operation is data destructive. The service makes no attempt to double check with the user. It simply moves forward. Clients applications performing the delete operation are advised to double check with the end user before sending the request. |
HTTP method and URI
DELETE /pools/default/buckets/[bucket-name]
Request data |
None |
Response data |
None |
Authentication required |
Yes |
Syntax
Curl request syntax:
curl -X DELETE -u [admin]:[password] http://[localhost]:8091//pools/default/buckets/[bucket-name]
Raw HTTP request syntax:
DELETE /pools/default/buckets/[bucket-name] Host: [localhost]:8091 Authorization: Basic xxxxxxxxxxxxxxxxxxx
Example
Curl request example to delete the bucket named myTestBucket:
curl -X DELETE -u Administrator:password \ http://10.5.2.54:8091/pools/default/buckets/myTestBucket
Raw HTTP request example to delete the bucket named myTestBucket:
DELETE /pools/default/buckets/myTestBucket Host: 10.5.2.54:8091 Authorization: Basic xxxxxxxxxxxxxxxxxxx