Object Storage Service：Go擷取儲存空間的資訊

儲存空間是對象（Object）的容器。您可以通過OSS Go SDK擷取訪問跟蹤狀態資訊、地區、建立日期、讀寫權限、擁有者的名稱和ID、儲存類型、資料容災類型、外網網域名稱、內網網域名稱、跨地區複製狀態、版本控制狀態、加密方式等內容，以便進行相應操作。例如，擷取外網網域名稱後結合Object名稱，即可訪問Object。

注意事項

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

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

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

• 要擷取儲存空間的資訊，您必須具有oss:GetBucketInfo許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。

• Go SDK 2.2.5及以上版本支援返回以下範例程式碼中包含的所有屬性。

範例程式碼

以下代碼用於擷取Bucket資訊。

package main

import (
	"log"

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

func main() {
	// 從環境變數中擷取訪問憑證。
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		log.Fatalf("Failed to get credentials from environment variables: %v", err)
	}

	// 建立OSSClient執行個體。
	// yourEndpoint填寫Bucket對應的Endpoint，以華東1（杭州）為例，填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
	// yourRegion填寫Bucket所在地區，以華東1（杭州）為例，填寫為cn-hangzhou。其它Region請按實際情況填寫。
	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
	clientOptions = append(clientOptions, oss.Region("yourRegion"))
	// 設定簽名版本
	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
	client, err := oss.New("yourEndpoint", "", "", clientOptions...)
	if err != nil {
		log.Fatalf("Failed to create new OSS client: %v", err)
	}

	// 填寫Bucket名稱，例如examplebucket。
	bucketName := "examplebucket"
	res, err := client.GetBucketInfo(bucketName)
	if err != nil {
		log.Fatalf("Failed to get bucket info for bucket '%s': %v", bucketName, err)
	}

	log.Printf("Bucket Info Name: %s\n", res.BucketInfo.Name)         // 列印Bucket名稱
	log.Printf("Bucket Info Location: %s\n", res.BucketInfo.Location) // 列印Bucket所在地區
}

常用儲存空間資訊列表

相關文檔

• 關於儲存空間的更多資訊，請參見儲存空間概述。

• 關於Bucket資訊的介面說明，請參見BucketInfo。