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