Delete Bucket

This API covers how to delete a bucket via the Service API.

Base Command :

DELETE <accesser>:8338/container/{bucket.name}

A DELETE issued to an empty bucket resource deletes the bucket.

After deleting a bucket the name is reserved by the system for 10 minutes and then released for re-use. Only empty buckets can be deleted.

This operation does not make sure use of operation specific headers, query parameters, or payload elements

There is no specific response parameter.

Table 1. HTTP Response Code
HTTP Response Code Description
204 No content No content
400 Bad Request Request contains too many request element, request timeout, invalid argument, the bucket is a vault, etc
401 Unauthorized Unauthorized
403 Forbidden Access Denied
404 Not Found The specified bucket does not exist
409 Conflict The bucket is not empty
410 Gone The bucket is already deleted.
500 Internal Server Error Internal Server Error

Example Output

Request
Delete <accesser>:8338/container/my-bucket

Response
HTTP/1.1 204 No Content

Example Delete Bucket Endpoint

Note: 204 No Content should be returned even if the container metadata does not have kms_endpoints or encryption_metadata in it.
Request
Delete <accesser>:8338/containers/container/{container-name}/metadata/encryption/kms_endpoints

Response
HTTP/1.1 204 No Content