本文介绍如何通过 TOS Go SDK 在已开启 ObjectSet 的 Bucket 中创建 ObjectSet，并可同时写入 ObjectSet 标签。

注意事项

Bucket 必须已开启 ObjectSet，可先调用 PutBucketObjectSetConfiguration。

ObjectSetName 必须满足 Bucket 的分隔符和 PathLevel 配置。

TagSet 为可选参数，每个 ObjectSet 最多可配置 10 个标签。

通过子账号调用时，需要具备当前 Bucket 的 tos:PutObjectSet 权限。

示例代码

package main​
​
import (​
   "context"​
   "fmt"​
   "os"​
​
   "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 ***"​
      // 填写 ObjectSet 名称，需满足 Bucket 的 PathLevel 和分隔符配置​
      objectSetName = "docs/object/set"​
      ctx        = context.Background()​
   )​
​
   // 初始化客户端​
   client, err := tos.NewClientV2(endpoint, tos.WithRegion(region), tos.WithCredentials(tos.NewStaticCredentials(accessKey, secretKey)))​
   checkErr(err)​
​
   input := &tos.PutObjectSetInput{​
      Bucket:        bucketName,​
      ObjectSetName: objectSetName,​
      TagSet: tos.TagSet{Tags: []tos.Tag{​
         {Key: "owner", Value: "go-sdk-example"},​
         {Key: "env", Value: "docs"},​
      }},​
   }​
   putOutput, err := client.PutObjectSet(ctx, input)​
   checkErr(err)​
   fmt.Println("PutObjectSet Request ID:", putOutput.RequestID)​
}​

对象存储