Deletes a bucket.
Note
- Only the owner of a bucket has the permissions to delete the bucket.
- To prevent unexpected deletion, Object Storage Service (OSS) does not allow you to delete a non-empty bucket.
Request syntax
DELETE / HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
Request headers
This request contains only common request headers. For more information, see Common request headers.
Response headers
This request contains only common response headers. For more information, see Common response headers.
Examples
- Sample requests for deleting an empty bucket
DELETE / HTTP/1.1 Host: test.oss-cn-hangzhou.aliyuncs.com Accept-Encoding: identity User-Agent: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0) Accept: */* Connection: keep-alive date: Tue, 15 Jan 2019 08:19:04 GMT authorization: OSS qn6qrrqxo2oawuk53otfjbyc:ceOEyZavKY4QcjoUWYSpYbJ3**** Content-Length: 0
Sample responsesHTTP/1.1 204 No Content Server: AliyunOSS Date: Tue, 15 Jan 2019 08:19:04 GMT Content-Length: 0 Connection: keep-alive x-oss-request-id: 5C3D9778CC1C2AEDF85B**** x-oss-server-time: 190
- Sample requests for deleting a bucket that does not exist
DELETE / HTTP/1.1 Host: test.oss-cn-hangzhou.aliyuncs.com Accept-Encoding: identity User-Agent: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0) Accept: */* Connection: keep-alive date: Tue, 15 Jan 2019 07:53:24 GMT authorization: OSS qn6qrrqxo2oawuk53otfjbyc:ceOEyZavKY4QcjoUWYSpYbJ3**** Content-Length: 0
Sample responsesHTTP/1.1 404 Not Found Server: AliyunOSS Date: Tue, 15 Jan 2019 07:53:25 GMT Content-Type: application/xml Content-Length: 288 Connection: keep-alive x-oss-request-id: 5C3D9175B6FC201293AD**** <?xml version="1.0" encoding="UTF-8"?> <Error> <Code>NoSuchBucket</Code> <Message>The specified bucket does not exist.</Message> <RequestId>5C3D9175B6FC201293AD****</RequestId> <HostId>test.oss-cn-hangzhou.aliyuncs.com</HostId> <BucketName>test</BucketName> </Error>
- Sample requests for deleting a non-empty bucket
DELETE / HTTP/1.1 Host: test.oss-cn-hangzhou.aliyuncs.com Accept-Encoding: identity User-Agent: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0) Accept: */* Connection: keep-alive date: Tue, 15 Jan 2019 07:35:06 GMT authorization: OSS qn6qrrqxo2oawuk53otfjbyc:ceOEyZavKY4QcjoUWYSpYbJ3**** Content-Length: 0
Sample responsesHTTP/1.1 409 Conflict Server: AliyunOSS Date: Tue, 15 Jan 2019 07:35:06 GMT Content-Type: application/xml Content-Length: 296 Connection: keep-alive x-oss-request-id: 5C3D8D2A0ACA54D87B43**** x-oss-server-time: 16 <?xml version="1.0" encoding="UTF-8"?> <Error> <Code>BucketNotEmpty</Code> <Message>The bucket you tried to delete is not empty.</Message> <RequestId>5C3D8D2A0ACA54D87B43****</RequestId> <HostId>test.oss-cn-hangzhou.aliyuncs.com</HostId> <BucketName>test</BucketName> </Error>
SDK
You can use OSS SDKs for the following programming languages to call DeleteBucket:
Error codes
Error code | HTTP status code | Description |
---|---|---|
AccessDenied | 403 Forbidden | The error message returned because you do not have the permissions to delete the bucket. Only the bucket owner can delete the bucket. |