帮你快速理解、总结文档立即下载
文档中心>对象存储>高性能存储>SDK 文档>Python SDK>存储桶操作>删除存储桶

删除存储桶

最近更新时间：2026-10-21 18:34:06
我的收藏

本页目录：

删除一个高性能桶（DELETE Bucket）。删除的目标桶由 Bucket 参数指定，请求使用基础凭证签名。

注意事项

删除桶前必须先清空桶内所有对象，否则会返回 BucketNotEmpty 错误。
删除的目标桶由 Bucket 参数指定，请确认桶名指向待删除的桶。
桶删除后不可恢复，请谨慎操作。
删除桶属于控制面接口，使用基础凭证签名，不走 session。

请求

方法原型

def delete_bucket(self, Bucket, **kwargs)

参数说明

参数名称
参数描述
类型
是否必选
Bucket
待删除的高性能桶完整名称，格式为 <BucketName>-x--<APPID>
string
是
kwargs
可选请求参数，使用本文列出的参数
dict
否

响应

参数名称
参数描述
类型
None
删除成功无返回内容，对应 HTTP 204
None

错误码

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

实际案例

# -*- coding=utf-8 -*-
import os
from qcloud_cos import CosConfig, CosS3Client

# 高性能桶经 VPC 内网 HTTP 80 端口接入，SDK 的网关 DNS 负载均衡也仅对 HTTP 请求生效；SDK 默认 https，此处需显式指定 http。
config = CosConfig(
    Scheme='http',
    Region='ap-guangzhou',
    SecretId=os.environ['COS_SECRET_ID'],
    SecretKey=os.environ['COS_SECRET_KEY'],
    Token=os.environ.get('COS_SECURITY_TOKEN'),
    EnableRapidDomain=True)
client = CosS3Client(config)

client.delete_bucket(Bucket='examplebucket-x--1250000000')
print('bucket deleted')

中国站