删除存储桶

最近更新时间: 2024-10-17 17:10:00

适用场景

当您在某些情况下需要删除存储桶时,您可以通过控制台、API 或 SDK 的方式来删除存储桶。

注意:

目前仅支持删除已经清空的存储桶,如果存储桶中仍有对象,将会删除失败。请在执行删除存储桶前确保存储桶内已经没有对象。

当删除存储桶时,您需要确保操作的身份已被授权该操作,并确认传入了正确的存储桶名称(Bucket)和地域(Region)参数。

使用方法

使用 REST API

您可以直接使用 REST API 发起一个删除存储桶请求,可参考 Delete Bucket 文档说明。

使用 Java SDK

对象存储 COS 的 Java SDK 中提供了此方法,可参考 Java SDK 接口文档 Delete Bucket 部分。

步骤说明

  1. 初始化客户端 cosclient。

  2. 执行 deleteBucket 删除 Bucket,Bucket 必须不包含任何数据,否则需要先清空数据。

代码示例

调用 deleteBucket 创建 Bucket,代码示例如下所示:

// 1 初始化用户身份信息(appid, secretId, secretKey)
COSCredentials cred = new BasicCOSCredentials("AKIDXXXXXXXX", "1A2Z3YYYYYYYYYY");
// 2 设置bucket的区域, COS地域的简称请参照 /document/product/436/6224
ClientConfig clientConfig = new ClientConfig(new Region("ap-beijing-1"));
// 3 生成cos客户端
COSClient cosclient = new COSClient(cred, clientConfig);

// bucket名称需包含appid
String bucketName = "publicreadbucket-1251668577";
// 删除bucket, 只能删除不包含任何数据的bucket
cosclient.deleteBucket(bucketName);