本文介绍如何通过 TOS Go SDK 根据 ObjectSet 标签设置默认 QoS 与容量配额规则。符合标签规则的 ObjectSet 可应用对应的默认流控和容量配置。

注意事项

Rules 不能为空。

同一请求中不应出现重复的 Tag.Key=Tag.Value。

该接口会覆盖 Bucket 当前的按标签配额规则。

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

示例代码

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 ***"​
      ctx        = context.Background()​
   )​
​
   // 初始化客户端​
   client, err := tos.NewClientV2(endpoint, tos.WithRegion(region), tos.WithCredentials(tos.NewStaticCredentials(accessKey, secretKey)))​
   checkErr(err)​
​
   input := &tos.PutObjectSetQuotaByTagInput{​
      Bucket: bucketName,​
      Rules: []tos.ObjectSetQuotaRule{​
         {​
            Tag:          tos.Tag{Key: "owner", Value: "go-sdk-docs"},​
            StorageQuota: "0",​
            Qos: tos.QosConfig{​
               ReadsQps:   0,​
               WritesQps:  0,​
               ListQps:    0,​
               ReadsRate:  0,​
               WritesRate: 0,​
            },​
         },​
      },​
   }​
   putOutput, err := client.PutObjectSetQuotaByTag(ctx, input)​
   checkErr(err)​
   fmt.Println("PutObjectSetQuotaByTag Request ID:", putOutput.RequestID)​
}​

对象存储