DeleteBucket

Last update:2025-08-18 15:50:19

This API is used to delete a specified storage bucket.

Note:
You can add the request header x-amz-force-delete-non-empty-bucket: true to force the deletion of a non-empty bucket. This will permanently delete all data within the bucket. Once deleted, the data cannot be recovered. Please use this operation with caution.

Request Syntax

DELETE / HTTP/1.1
Host: quotes.s3.<Region>.amazonaws.com
Date: Wed, 01 Mar 2006 12:00:00 GMT
Authorization: authorization string

URI Request Parameters

None

Request Headers

Use Common Request Headers.

Request Body

None

Response Syntax

HTTP/1.1 204 OK

x-wos-request-id: request id
Content-Type: type
Date: date
Content-Length: length
Server: WS-web-server

Response Headers

Use Common Response Headers.

Response Elements

None

Exceptional Scenarios

Scenario Status Code Response Message
Bucket does not exist 404 BucketNotFound
IAM validation failed 403 AccessDenied

Example

DELETE / HTTP/1.1
Host: BucketName.s3-cn-south-6.wcsapi.com
Date: GMT Date
Authorization: SignatureValue

HTTP/1.1 204 OK
x-wos-request-id: request id
Content-Type: type
Date: date
Content-Length: length
Server: WS-web-server
Is the content of this document helpful to you?
Yes
I have suggestion
Submitted successfully! Thank you very much for your feedback, we will continue to strive to do better!