A newer version of this documentation is available.

View Latest

Deleting Buckets

  • reference
    +
    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 200 response code is returned.

    • If the bucket is not deleted on all servers within the 30 second timeout, a 500 error code is returned.

    • If the bucket is not deleted on all servers and another request is made to delete the bucket, a 404 error code is returned.

    • If the bucket is not deleted on all servers and a request is made to create 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

    Response codes

    Response codes Description

    200

    OK Bucket Deleted on all nodes

    401

    Unauthorized

    404

    Object Not Found

    500

    Bucket could not be deleted on all nodes

    503

    Buckets cannot be deleted during a rebalance