文档中心

删除桶（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();

对象存储

删除桶（Node.js SDK）

注意事项

前提条件

示例代码

相关文档