You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /对象存储/SDK 参考/Harmony/存储桶接口/桶基础接口/获取桶地域（Harmony SDK）
获取桶地域（Harmony SDK）
最近更新时间：2024.12.23 17:29:48首次发布时间：2024.12.23 17:29:48
我的收藏

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

注意事项

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

示例代码

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

// 创建客户端
const client = new TosClient({
  accessKeyId: "Provide your ak", 
  accessKeySecret: "Provide your sk", 
  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.getBucketLocation({ Bucket: bucketName });
    // 查看存储桶地域
    console.log('Bucket Region:', res.Region);
    // 查看存储桶外网域名
    console.log('Bucket ExtranetEndpoint:', res.ExtranetEndpoint);
    // 查看存储桶内网域名
    console.log('Bucket IntranetEndpoint:', res.IntranetEndpoint);
  } catch (error) {
    handleError(error);
  }
}

main();

相关文档

关于获取桶地域的 API 文档，请参见 GetBucketLocation。