当您不再需要保留某个桶（Bucket）时，可将其删除，以免产生额外费用。

注意事项

• 桶删除后不可恢复，请谨慎操作。
• 删除桶之前，您必须具备 tos:DeleteBucket 权限。

前提条件

删除桶之前，请确保您已经删除桶中所有数据。

• 如果桶开启了版本控制，请确保已删除当前桶内所有当前版本和历史版本对象。具体操作，请参见删除对象。
• 如果桶中存在未合并的分片，请确保删除所有分片数据，具体操作。请参见删除分片。
• 如果桶中的对象较多，您可以通过生命周期规则，设置对象的批量删除。具体操作，请参见设置生命周期规则。

示例代码

import { TosClient, TosClientError, TosServerError } from '@volcengine/tos_harmonyos_sdk';

// 创建客户端
const client = new TosClient({
  accessKeyId: "Provide your ak', 
  accessKeySecret: "Provide your ak", 
  securityToken: 'Provide your securityToken',
  region: "Provide your region", // 填写 Bucket 所在地域。以华北2（北京)为例，"Provide your region" 填写为 cn-beijing。
  endpoint: "Provide your endpoint", // 填写域名地址
});

function handleError(error: Error) {
  if (error instanceof TosClientError) {
    console.log('Client Err Msg:', error.message);
    console.log('Client Err Stack:', error.stack);
  } else if (error instanceof TosServerError) {
    console.log('Request ID:', error.requestId);
    console.log('Response Status Code:', error.statusCode);
    console.log('Response Header:', error.headers);
    console.log('Response Err Code:', error.code);
    console.log('Response Err Msg:', error.message);
  } else {
    console.log('unexpected exception, message: ', error);
  }
}

const bucketName = 'harmonyos-sdk-test-bucket';
async function main() {
  try {
    // 判断桶是否存在
    const res = await client.deleteBucket({
      Bucket: bucketName
    });
    console.log(`the status code of delete ${bucketName} is`, res.StatusCode);
  } catch (error) {
    handleError(error);
  }
}

main();

相关文档

关于删除桶的 API 文档，请参见 DeleteBucket。