删除存储桶
最近更新时间: 2024-10-17 17:10:00
功能描述
Delete Bucket 接口请求可以在指定账号下删除 Bucket，删除之前要求 Bucket 内的内容为空，只有删除了 Bucket 内的信息，才能删除 Bucket 本身。
请求
语法示例：
DELETE / HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: GMT Date
Authorization: Auth String说明：
Authorization: Auth String (详细参见请求签名章节)。
请求行
DELETE / HTTP/1.1该 API 接口接受 DELETE 请求。
请求头
公共头部
该请求操作的实现使用公共请求头,了解公共请求头详细请参见 公共请求头部 章节。
非公共头部
该请求操作无特殊的请求头部信息。
请求体
该请求的请求体为空。
响应
响应头
公共响应头
该响应使用公共响应头,了解公共响应头详细请参见 公共响应头部 章节。
特有响应头
该响应无特殊的响应头。
响应体
该响应体返回为空。
错误分析
以下描述此请求可能会发生的一些特殊的且常见的错误情况：
| 错误码 | 描述 | HTTP状态码 |
|---|---|---|
| BucketNotEmpty | 409 Conflict | 不能删除一个非空的 Bucket。 |
| AccessDenied | 403 Forbidden | 删除 Bucket 同样需要携带签名，如果试图删除一个没有访问权限的 Bucket，就会返回该错误。 |
| NoSuchBucket | 404 Not Found | 如果删除一个不存在的 Bucket，就回返回该错误。 |
获取更多关于 COS 的错误码的信息，或者产品所有的错误列表，请查看 错误码 文档。
实际案例
请求
DELETE / HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: Wed, 23 Oct 2016 21:32:00 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUjfGFO&q-sign-time=1484708950;32557604950&q-key-time=1484708950;32557604950&q-header-list=host&q-url-param-list=&q-signature=2b27b72ad2540ff2dde341dc7579a66ee8cb2afc
响应
HTTP/1.1 204 OK
Content-Type: application/xml
Content-Length: 0
Connection: keep-alive
Date: Wed, 23 Oct 2016 21:32:00 GMT
x-cos-request-id: NTg3ZWRjNjBfOTgxZjRlXzZhYjlfMTg0