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

文档中心

立即注册

导航

对象存储

获取桶地域（Go SDK）

最近更新时间：2024.02.04 18:31:01首次发布时间：2023.01.18 16:55:21

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

注意事项

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

示例代码

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

package main

import (
   "context"
   "fmt"

   "github.com/volcengine/ve-tos-golang-sdk/v2/tos"
)

func checkErr(err error) {
   if err != nil {
      if serverErr, ok := err.(*tos.TosServerError); ok {
         fmt.Println("Error:", serverErr.Error())
         fmt.Println("Request ID:", serverErr.RequestID)
         fmt.Println("Response Status Code:", serverErr.StatusCode)
         fmt.Println("Response Header:", serverErr.Header)
         fmt.Println("Response Err Code:", serverErr.Code)
         fmt.Println("Response Err Msg:", serverErr.Message)
      } else if clientErr, ok := err.(*tos.TosClientError); ok {
         fmt.Println("Error:", clientErr.Error())
         fmt.Println("Client Cause Err:", clientErr.Cause.Error())
      } else {
         fmt.Println("Error:", err)
      }
      panic(err)
   }
}

func main() {
   var (
      accessKey = os.Getenv("TOS_ACCESS_KEY")
      secretKey = os.Getenv("TOS_SECRET_KEY")
      // Bucket 对应的 Endpoint，以华北2（北京）为例：https://tos-cn-beijing.volces.com
      endpoint = "https://tos-cn-beijing.volces.com"
      region   = "cn-beijing"
      // 填写 BucketName
      bucketName = "*** Provide your bucket name ***"
   )
   // 初始化客户端
   client, err := tos.NewClientV2(endpoint, tos.WithRegion(region), tos.WithCredentials(tos.NewStaticCredentials(accessKey, secretKey)))
   checkErr(err)
   // 查看存储桶地域信息
   output, err := client.GetBucketLocation(context.Background(), &tos.GetBucketLocationInput{Bucket: bucketName})
   checkErr(err)
   fmt.Println("GetBucketLocation Request ID:", output.RequestID)
   // 查看存储桶地域
   fmt.Println("Bucket Region:", output.Region)
   // 查看存储桶外网域名
   fmt.Println("Bucket ExtranetEndpoint:", output.ExtranetEndpoint)
   // 查看存储桶内网域名
   fmt.Println("Bucket IntranetEndpoint:", output.IntranetEndpoint)
}