全部產品
Search

搜尋本產品

    Object Storage Service：Go管理版本控制

    文件中心

    Object Storage Service：Go管理版本控制

    更新時間：Feb 21, 2025

    版本控制應用於儲存空間（Bucket）內的所有檔案（Object）。通過Object的版本管理，在錯誤覆蓋或者刪除Object後，您能夠將Bucket中儲存的Object恢複至任意時刻的歷史版本。

    注意事項

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

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

    • 要設定Bucket版本控制狀態，您必須具有oss:PutBucketVersioning許可權；要擷取Bucket版本控制狀態資訊，您必須具有oss:GetBucketVersioning許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。

    方法定義

    設定Bucket版本控制狀態

    func (c *Client) PutBucketVersioning(ctx context.Context, request *PutBucketVersioningRequest, optFns ...func(*Options)) (*PutBucketVersioningResult, error)

    擷取Bucket版本控制狀態資訊

    func (c *Client) GetBucketVersioning(ctx context.Context, request *GetBucketVersioningRequest, optFns ...func(*Options)) (*GetBucketVersioningResult, error)

    請求參數列表

    參數名

    類型

    說明

    ctx

    context.Context

    請求的上下文，可以用來佈建要求的總時限

    request

    *PutBucketVersioningRequest

    設定Bucket版本控制的請求參數，具體請參見PutBucketVersioningRequest

    *GetBucketVersioningRequest

    擷取Bucket版本控制狀態資訊的請求參數，具體請參見GetBucketVersioningRequest

    optFns

    ...func(*Options)

    （可選）介面級的配置參數, 具體請參見Options

    傳回值列表

    傳回值名

    類型

    說明

    result

    *PutBucketVersioningResult

    設定Bucket版本控制的介面傳回值，當 err 為nil 時有效，具體請參見PutBucketVersioningResult

    *GetBucketVersioningResult

    擷取Bucket版本控制狀態資訊的介面傳回值，當err為nil時有效，具體請參見GetBucketVersioningResult

    err

    error

    請求的狀態，當請求失敗時，err 不為 nil

    範例程式碼

    設定Bucket版本控制狀態

    您可以使用以下代碼設定Bucket為開啟版本控制（Enabled）狀態。

    package main

import (
	"context"
	"flag"
	"log"

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

// 定義全域變數
var (
	region     string // 儲存地區
	bucketName string // 儲存空間名稱
)

// init函數用於初始化命令列參數
func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.")
}

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

	// 檢查bucket名稱是否為空白
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}

	// 檢查region是否為空白
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}

	// 載入預設配置並設定憑證提供者和地區
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	// 建立OSS用戶端
	client := oss.NewClient(cfg)

	// 建立設定儲存空間版本控制的請求
	putRequest := &oss.PutBucketVersioningRequest{
		Bucket: oss.Ptr(bucketName), // 儲存空間名稱
		VersioningConfiguration: &oss.VersioningConfiguration{
			Status: oss.VersionEnabled, // 啟用版本控制
		},
	}

	// 執行開啟儲存空間版本控制的請求
	putResult, err := client.PutBucketVersioning(context.TODO(), putRequest)
	if err != nil {
		log.Fatalf("failed to put bucket versioning %v", err)
	}

	// 列印開啟儲存空間版本控制的結果
	log.Printf("put bucket versioning result:%#v\n", putResult)
}

    擷取Bucket版本控制狀態資訊

    您可以使用以下代碼擷取Bucket版本控制狀態資訊。

    package main

import (
	"context"
	"flag"
	"log"

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

// 定義全域變數
var (
	region     string // 儲存地區
	bucketName string // 儲存空間名稱
)

// init函數用於初始化命令列參數
func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.")
}

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

	// 檢查bucket名稱是否為空白
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}

	// 檢查region是否為空白
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}

	// 載入預設配置並設定憑證提供者和地區
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	// 建立OSS用戶端
	client := oss.NewClient(cfg)

	// 建立擷取儲存空間版本控制狀態資訊的請求
	getRequest := &oss.GetBucketVersioningRequest{
		Bucket: oss.Ptr(bucketName), // 儲存空間名稱
	}

	// 執行擷取儲存空間版本控制狀態資訊的操作
	getResult, err := client.GetBucketVersioning(context.TODO(), getRequest)
	if err != nil {
		log.Fatalf("failed to get bucket versioning %v", err)
	}

	// 列印擷取儲存空間版本控制狀態資訊的結果
	log.Printf("get bucket versioning result:%#v\n", getResult)
}

    相關文檔