Object Storage Service：Go擷取對象標籤

注意事項

• 本文以華東1（杭州）外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS，請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係，請參見訪問網域名稱和資料中心。

• 本文以從環境變數讀取存取憑證為例。如何配置訪問憑證，請參見配置訪問憑證。

• 本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient，請參見初始化。

• 要擷取對象標籤，您必須具有oss:GetObjectTagging許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。

擷取Object標籤資訊

當儲存空間（Bucket）未開啟版本控制時，您可以根據需要擷取Object標籤資訊。當Bucket已開啟版本控制時，OSS預設只擷取Object目前的版本標籤資訊。

以下代碼用於擷取目標儲存空間examplebucket中exampledir目錄下的exampleobject.txt檔案的標籤資訊。

package main

import (
    "fmt"
    "os"

    "github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
    // 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
    provider, err := oss.NewEnvironmentVariableCredentialsProvider()
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }
    // 建立OSSClient執行個體。
    // yourEndpoint填寫Bucket對應的Endpoint，以華東1（杭州）為例，填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
    client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }

    // 填寫Bucket名稱，例如examplebucket。
    bucketName := "examplebucket"
    // 填寫Object完整路徑，例如exampledir/exampleobject.txt。Object完整路徑中不能包含Bucket名稱。
    objectName := "exampledir/exampleobject.txt"

    // 擷取儲存空間。
    bucket, err := client.Bucket(bucketName)
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }

    // 擷取Object標籤資訊。
    taggingResult, err := bucket.GetObjectTagging(objectName)
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }
    fmt.Printf("Object Tagging: %v\n", taggingResult)
}

擷取Object指定版本標籤資訊

當Bucket已開啟版本控制時，通過指定Object的版本ID（versionId），您可以擷取Object指定版本標籤資訊。

以下代碼用於擷取目標儲存空間examplebucket中exampledir目錄下的exampleobject.txt檔案指定版本的標籤資訊。

package main

import (
	"fmt"
	"github.com/aliyun/aliyun-oss-go-sdk/oss"
	"os"
)

func HandleError(err error) {
	fmt.Println("Error:", err)
	os.Exit(-1)
}

func main() {
	// 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	// 建立OSSClient執行個體。
	// yourEndpoint填寫Bucket對應的Endpoint，以華東1（杭州）為例，填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
	client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	// 填寫Bucket名稱，例如examplebucket。
	bucketName := "examplebucket"
	// 填寫Object完整路徑，例如exampledir/exampleobject.txt。Object完整路徑中不能包含Bucket名稱。
	objectName := "exampledir/exampleobject.txt"
	// 填寫Object的版本ID。
	versionId := "CAEQMxiBgICAof2D0BYiIDJhMGE3N2M1YTI1NDQzOGY5NTkyNTI3MGYyMzJm****"

	// 擷取儲存空間。
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		HandleError(err)
	}

	// 擷取Object指定版本標籤資訊。
	taggingResult, err := bucket.GetObjectTagging(objectName, oss.VersionId(versionId))

	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	fmt.Printf("Object Tagging: %v\n", taggingResult)
}