You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

复制全文
下载 pdf
基础操作
查询 ObjectSet( Go SDK)
复制全文
下载 pdf
查询 ObjectSet( Go SDK)
本文介绍如何通过 TOS Go SDK 查询指定 ObjectSet 的名称和标签集合。​
注意事项​
  • ObjectSet 必须存在。​
  • ObjectSetName 需要满足 Bucket 的 ObjectSet 分隔符和层级配置。​
  • 通过子账号调用时,需要具备当前 Bucket 的 tos:GetObjectSet 权限。​
示例代码​
​
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)​
​
getOutput, err := client.GetObjectSet(ctx, &tos.GetObjectSetInput{​
Bucket: bucketName,​
ObjectSetName: objectSetName,​
})​
checkErr(err)​
fmt.Println("GetObjectSet Request ID:", getOutput.RequestID)​
fmt.Println("ObjectSetName:", getOutput.ObjectSetName)​
for _, tag := range getOutput.TagSet.Tags {​
fmt.Printf("Tag: %s=%s\n", tag.Key, tag.Value)​
}​
}​
​
相关文档​
关于查询指定 ObjectSet 的名称和标签集合的相关 API 接口,请参见 GetObjectSet。​
​
最近更新时间:2026.06.04 17:37:36
这个页面对您有帮助吗?
有用
有用
无用
无用