全部產品
Search
文件中心

Object Storage Service:歸檔直讀(Go SDK V2)

更新時間:Aug 02, 2025

本文介紹如何使用Go SDK V2為Bucket開啟或關閉歸檔直讀的功能。

注意事項

  • 本文範例程式碼以華東1(杭州)的地區IDcn-hangzhou為例,預設使用外網Endpoint,如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS,請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係,請參見OSS地區和訪問網域名稱

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

範例程式碼

開啟Bucket歸檔直讀

您可以使用以下代碼開啟Bucket歸檔直讀。

package main

import (
	"context" 
	"flag"  
	"log"   

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"           // 阿里雲OSS服務的SDK包
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials" // 處理認證資訊的包
)

var (
	region     string // 定義一個變數來儲存從命令列擷取的地區(Region)資訊
	bucketName string // 定義一個變數來儲存從命令列擷取的儲存空間名稱
)

// init函數在main函數之前執行,用來初始化程式。
func init() {
	// 設定命令列參數來指定region,預設為空白字串
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	// 設定命令列參數來指定bucket名稱,預設為空白字串
	flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.")
}

func main() {
	flag.Parse() // 解析命令列參數

	// 檢查是否提供了儲存空間名稱,如果沒有提供,則輸出預設參數並退出程式
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required") // 記錄錯誤並終止程式
	}

	// 檢查是否提供了地區資訊,如果沒有提供,則輸出預設參數並退出程式
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required") // 記錄錯誤並終止程式
	}

	// 建立設定物件,並使用環境變數作為憑證提供者和指定的地區
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	client := oss.NewClient(cfg) // 使用配置建立一個新的OSS用戶端執行個體

	// 構建一個PutBucketArchiveDirectRead請求,用於啟用特定儲存空間的歸檔直讀功能
	request := &oss.PutBucketArchiveDirectReadRequest{
		Bucket: oss.Ptr(bucketName), // 指定要操作的儲存空間名稱
		ArchiveDirectReadConfiguration: &oss.ArchiveDirectReadConfiguration{
			Enabled: oss.Ptr(true), // 啟用歸檔直讀配置。設定true為開啟歸檔直讀,設定false為關閉歸檔直讀
		},
	}
	result, err := client.PutBucketArchiveDirectRead(context.TODO(), request) // 發送請求以設定儲存空間的歸檔直讀配置
	if err != nil {
		log.Fatalf("failed to put bucket archive direct read %v", err) // 如果有錯誤發生,記錄錯誤資訊並終止程式
	}

	log.Printf("put bucket archive direct read result:%#v\n", result) // 列印設定儲存空間歸檔直讀的結果
}

查看Bucket是否開啟歸檔直讀

您可以使用以下代碼查看Bucket是否開啟歸檔直讀。

package main

import (
	"context" 
	"flag"   
	"log"   

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"           // 阿里雲OSS服務的SDK包
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials" // 處理認證資訊的包
)

var (
	region     string // 定義一個變數來儲存從命令列擷取的地區(Region)資訊
	bucketName string // 定義一個變數來儲存從命令列擷取的儲存空間名稱
)

// init函數在main函數之前執行,用來初始化程式。
func init() {
	// 設定命令列參數來指定region,預設為空白字串
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	// 設定命令列參數來指定bucket名稱,預設為空白字串
	flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.")
}

func main() {
	flag.Parse() // 解析命令列參數

	// 檢查是否提供了儲存空間名稱,如果沒有提供,則輸出預設參數並退出程式
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required") // 記錄錯誤並終止程式
	}

	// 檢查是否提供了地區資訊,如果沒有提供,則輸出預設參數並退出程式
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required") // 記錄錯誤並終止程式
	}

	// 建立設定物件,並使用環境變數作為憑證提供者和指定的地區
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	client := oss.NewClient(cfg) // 使用配置建立一個新的OSS用戶端執行個體

	// 構建一個GetBucketArchiveDirectRead請求,用於擷取特定儲存空間的歸檔直讀配置(假設存在)
	request := &oss.GetBucketArchiveDirectReadRequest{
		Bucket: oss.Ptr(bucketName), // 指定要查詢的儲存空間名稱
	}
	result, err := client.GetBucketArchiveDirectRead(context.TODO(), request) // 發送請求以擷取儲存空間的歸檔直讀配置(假設存在)
	if err != nil {
		log.Fatalf("failed to get bucket archive direct read %v", err) // 如果有錯誤發生,記錄錯誤資訊並終止程式
	}

	log.Printf("get bucket archive direct read result:%#v\n", result) // 列印擷取到的歸檔直讀配置結果(假設存在)
}

相關文檔