DELETE Bucket

最近更新时间:2019-07-01 17:39:13

功能描述

DELETE Bucket 请求用于删除指定的存储桶。该 API 的请求者需要对存储桶有写入权限。

注意:

删除存储桶前,请确保存储桶内的数据和未完成上传的分块数据已全部清空,否则会无法删除存储桶。

请求

请求示例

DELETE / HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String

说明:

Authorization: Auth String (详情请参阅 请求签名 文档)。

请求参数

此接口无请求参数。

请求头

此接口仅使用公共请求头部,详情请参阅 公共请求头部 文档。

请求体

此接口无请求体。

响应

响应头

此接口仅返回公共响应头部,详情请参阅 公共响应头部 文档。

响应体

此接口响应体为空。

错误码

此接口的特殊错误信息如下所述,全部错误信息请参阅 错误码 文档。

错误码 描述 HTTP 状态码
BucketNotEmpty 存储桶不为空 409 Conflict
NoSuchBucket 指定的存储桶不存在 404 Not Found

实际案例

请求

DELETE / HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Tue, 28 May 2019 03:19:13 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1559013553;1559020753&q-key-time=1559013553;1559020753&q-header-list=date;host&q-url-param-list=&q-signature=478b1db6182db32c8ed459dfa723a9f500b2****
Connection: close

响应

HTTP/1.1 204 No Content
Content-Length: 0
Connection: close
Date: Tue, 28 May 2019 03:19:14 GMT
Server: tencent-cos
x-cos-request-id: NWNlY2E4YjFfNjljMDBiMDlfMmNiZTlfZGE0****