存儲空間是對象（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。