帮你快速理解、总结文档立即下载

DeleteBucket

最近更新时间:2026-10-21 18:34:04
我的收藏
DeleteBucket 接口请求用于删除指定的存储桶。

注意事项

删除存储桶前,请确保存储桶内的对象(含目录对象)已全部清空,否则接口返回 409 Conflict,错误码为 BucketNotEmpty。
删除目标存储桶不存在时,接口仍按删除成功处理,返回 204 No Content。

请求

请求语法

DELETE / HTTP/1.1
Host: <BucketName>-x--<APPID>.cosrapid.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明:
Authorization 字段的具体格式见 公共请求头部。

请求参数

此接口无请求参数。

请求头部

此接口仅使用 公共请求头部,无私有请求头部。

请求体

该请求的请求体为空。

响应

响应头部

仅返回 公共响应头部,本接口无私有响应头部。

响应体

请求成功,响应体为空。

错误码

本接口遵循统一的错误响应和错误码,详情请参见 错误码 文档。

实际案例

请求

DELETE / HTTP/1.1
Host: examplebucket-x--1250000000.cosrapid.ap-guangzhou.myqcloud.com
Date: Fri, 13 Oct 2023 09:13:10 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDXXXXXXXX&q-sign-time=1484813288;32557709288&q-key-time=1484813288;32557709288&q-header-list=date;host&q-url-param-list=&q-signature=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

响应

HTTP/1.1 204 No Content
Content-Length: 0
Date: Fri, 13 Oct 2023 09:13:10 GMT
x-cos-request-id: NjUwMDAwMDAwMDAwMDAwMDAw