文档中心

列举桶（Node.js SDK）

最近更新时间：2024.02.04 18:30:56

首次发布时间：2022.05.13 18:28:15

通过 ListBuckets 获取存储桶（Bucket）列表。您可以列举当前账号所有地域下符合指定条件的存储空间。

注意事项

列举桶之前，您必须具有 tos:ListBuckets 权限。具体操作，请参见权限配置指南。
ListBuckets 接口会返回当前账号所有地域的桶。

示例代码

以下代码用于列举当前账号所有区域的桶。

// 导入 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);
  }
}

async function main() {
  try {
    const { data } = await client.listBuckets();
    console.log(`listBuckets data: `, data);
  } catch (error) {
    handleError(error);
  }
}

main();

对象存储

列举桶（Node.js SDK）

注意事项

示例代码

相关文档