DeleteBucket
Deletes a bucket from QStorage.
Description
The DeleteBucket operation deletes the bucket specified in the request. All objects (including all object versions and delete markers) in the bucket must be deleted before the bucket itself can be deleted.
warning
- The bucket you want to delete must be empty.
- Once a bucket is deleted, the name becomes available for reuse by any account.
- This operation is not reversible.
Request Syntax
DELETE / HTTP/1.1
Host: BucketName.qstorage.quilibrium.com
x-amz-expected-bucket-owner: OwnerAccountId
Values in italics indicate user input and should be replaced with actual values.
This operation does not have a request body.
Request Parameters
Headers
| Name | Description | Required | Type |
|---|---|---|---|
| x-amz-expected-bucket-owner | The account ID of the expected bucket owner | No | text |
Examples
DELETE / HTTP/1.1
Host: my-bucket.qstorage.quilibrium.com
x-amz-expected-bucket-owner: 123456789012
Values in italics indicate user input and should be replaced with actual values.
HTTP/1.1 204
x-amz-id-2: Example7qoYGN7uMuFuYS6m7a4l
x-amz-request-id: TX234S0F24A06C7
Date: Wed, 01 Mar 2024 12:00:00 GMT
Values in italics indicate variable response values.
Response Syntax
HTTP/1.1 204
x-amz-id-2: RequestId
x-amz-request-id: AmazonRequestId
Date: ISO8601Date
Values in italics indicate variable response values.
Response Elements
Response Headers
| Name | Description | Required | Type |
|---|---|---|---|
| x-amz-id-2 | An identifier for the request | No | String |
| x-amz-request-id | A unique identifier for the request | No | String |
| Date | The date and time at which the response was sent | No | String |
This operation does not return a response body.
Special Errors
| Error Code | Description |
|---|---|
| BucketNotEmpty | The bucket you tried to delete is not empty. You must delete all objects from the bucket before you can delete the bucket. |
| NoSuchBucket | The specified bucket does not exist. |
| 403 | Forbidden. Authentication failed or you do not have permission to delete the bucket. |
Permissions
You must have the s3:DeleteBucket permission.
Try It Out
Test DeleteBucket
Delete an empty bucket from QStorage.
Coming Soon
This feature is currently under development and will be available soon.