Go獲取文件元數(shù)據(jù)
默認(rèn)情況下,在受版本控制的存儲(chǔ)空間(Bucket)中調(diào)用GetObjectMeta接口僅獲取文件(Object)當(dāng)前版本的元數(shù)據(jù)。如果您需要返回指定版本Object的元數(shù)據(jù),您可以在請(qǐng)求參數(shù)中指定版本ID。
注意事項(xiàng)
本文以華東1(杭州)外網(wǎng)Endpoint為例。如果您希望通過(guò)與OSS同地域的其他阿里云產(chǎn)品訪(fǎng)問(wèn)OSS,請(qǐng)使用內(nèi)網(wǎng)Endpoint。關(guān)于OSS支持的Region與Endpoint的對(duì)應(yīng)關(guān)系,請(qǐng)參見(jiàn)OSS訪(fǎng)問(wèn)域名、數(shù)據(jù)中心、開(kāi)放端口。
本文以從環(huán)境變量讀取訪(fǎng)問(wèn)憑證為例。如何配置訪(fǎng)問(wèn)憑證,請(qǐng)參見(jiàn)配置訪(fǎng)問(wèn)憑證。
本文以OSS域名新建OSSClient為例。如果您希望通過(guò)自定義域名、STS等方式新建OSSClient,請(qǐng)參見(jiàn)初始化。
要獲取文件元數(shù)據(jù),您必須有
oss:GetObject
權(quán)限。具體操作,請(qǐng)參見(jiàn)為RAM用戶(hù)授權(quán)自定義的權(quán)限策略。
示例代碼
以下代碼用于獲取Object指定版本的元數(shù)據(jù):
package main
import (
"log"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
// 從環(huán)境變量中獲取訪(fǎng)問(wèn)憑證。運(yùn)行本代碼示例之前,請(qǐng)確保已設(shè)置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
log.Fatalf("Failed to create credentials provider: %v", err)
}
// 創(chuàng)建OSSClient實(shí)例。
// yourEndpoint填寫(xiě)B(tài)ucket對(duì)應(yīng)的Endpoint,以華東1(杭州)為例,填寫(xiě)為https://oss-cn-hangzhou.aliyuncs.com。其它Region請(qǐng)按實(shí)際情況填寫(xiě)。
// yourRegion填寫(xiě)B(tài)ucket所在地域,以華東1(杭州)為例,填寫(xiě)為cn-hangzhou。其它Region請(qǐng)按實(shí)際情況填寫(xiě)。
clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
clientOptions = append(clientOptions, oss.Region("yourRegion"))
// 設(shè)置簽名版本
clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
client, err := oss.New("yourEndpoint", "", "", clientOptions...)
if err != nil {
log.Fatalf("Failed to create OSS client: %v", err)
}
// 填寫(xiě)不包含Bucket名稱(chēng)在內(nèi)的Object的完整路徑,例如exampleobject.txt。
objectName := "exampleobject.txt"
// 填寫(xiě)Object所在的Bucket名稱(chēng),例如examplebucket。
bucketName := "examplebucket"
bucket, err := client.Bucket(bucketName)
if err != nil {
log.Fatalf("Failed to get bucket '%s': %v", bucketName, err)
}
// 獲取指定版本Object的部分元數(shù)據(jù)。
// youObjectVersionId填寫(xiě)Object的版本ID。
versionId := "youObjectVersionId"
props, err := bucket.GetObjectMeta(objectName, oss.VersionId(versionId))
if err != nil {
log.Fatalf("Failed to get object meta: %v", err)
}
log.Printf("Object Meta (Partial): %+v", props)
// 獲取指定版本文件的所有元數(shù)據(jù)。
props, err = bucket.GetObjectDetailedMeta(objectName, oss.VersionId(versionId))
if err != nil {
log.Fatalf("Failed to get object detailed meta: %v", err)
}
log.Printf("Object Meta (Detailed): %+v", props)
}
相關(guān)文檔
關(guān)于獲取文件元數(shù)據(jù)的完整示例代碼,請(qǐng)參見(jiàn)GitHub示例。
關(guān)于獲取文件元數(shù)據(jù)的API接口說(shuō)明,請(qǐng)參見(jiàn)GetObjectMeta和GetObjectDetailedMeta。