获取桶地域（Node.js SDK）--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

获取桶地域（Node.js SDK）

最近更新时间：2024.02.04 18:31:05首次发布时间：2023.07.04 15:29:42

存储桶（Bucket）是 TOS 的全局唯一的命名空间，相当于数据的容器，用来储存对象（Object）数据。本文介绍如何获取桶所在的地域信息。

注意事项

默认只有桶的所有者才能查看桶所在的地域。
使用 TOS Node.js SDK 对桶以及桶内对象进行管理时，您必须使用桶所在地域的域名。关于地域与访问域名的更多信息，请参见地域和访问域名。

示例代码

以下代码用于获取存储桶的地域（Region）。

// 导入 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.getBucketLocation({ bucket: bucketName });
    // 查看存储桶地域
    console.log('Bucket Region:', data.Region);
    // 查看存储桶外网域名
    console.log('Bucket ExtranetEndpoint:', data.ExtranetEndpoint);
    // 查看存储桶内网域名
    console.log('Bucket IntranetEndpoint:', data.IntranetEndpoint);
  } catch (error) {
    handleError(error);
  }
}

main();