删除存储桶
更新时间:2024-07-26
接口说明
本接口用于删除一个Bucket。在删除前需要保证此Bucket下的所有Object和未完成的三步上传Part已经已被删除,否则会删除失败。
注意事项
- 删除Bucket之前确认该Bucket没有开通跨区域复制,不是跨区域复制规则中的源Bucket或目标Bucket,否则不能删除。
- 只有Bucket的拥有者才能删除对应的Bucket,否则返回403 Forbidden,对应错误信息:AccessDenied。
- 为了确保用户数据安全,防止误删除,BOS不允许用户删除一个非空的Bucket。如果用户试图删除一个存在Object的Bucket,返回409 Conflict错误,错误码:BucketNotEmpty。
在线调试
请求URI
DELETE /v1/{bucketName}
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 | 参数位置 |
---|---|---|---|---|---|
bucketName | String | 是 | 待删除bucket的名称 | "bucketName_example" | Path |
请求体参数
请求体字段数据结构说明
响应体参数
响应体字段数据结构说明
请求示例
DELETE /v1/bucketName_example
<公共请求头>
{ }
响应示例
HTTP/1.1 200 OK
<公共响应头>
{ }
错误码
请参考通用错误码