You need to enable JavaScript to run this app.
导航
删除桶(Node.js SDK)
最近更新时间:2024.02.04 18:30:56首次发布时间:2022.05.13 18:28:15

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

注意事项

  • 桶删除后不可恢复,请谨慎操作。
  • 删除桶之前,您必须具备 tos:DeleteBucket 权限。具体操作,请参见权限配置指南

前提条件

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

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

示例代码

// 导入 SDK, 当 TOS Node.JS SDK 版本小于 2.5.2 请把下方 TosClient 改成 TOS 导入
import { TosClient, TosClientError, TosServerError } from '@volcengine/tos-sdk';

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

function handleError(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 = 'node-sdk-test-bucket';
async function main() {
  try {
    // 判断桶是否存在
    const { data } = await client.deleteBucket(bucketName);
    console.log(`the result of delete ${bucketName} is`, data);
  } catch (error) {
    handleError(error);
  }
}

main();

相关文档

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