通過Go SDK V2在版本控制的Bucket中刪除檔案 - Object Storage Service

對於開啟了版本控制的Bucket，OSS支援根據是否傳入versionId控制對象（Object）被臨時刪除或是徹底刪除。您可以結合這個特性對單個、多個或者指定首碼的Object進行刪除操作。

注意事項

本文範例程式碼以華東1（杭州）的地區IDcn-hangzhou為例，預設使用外網Endpoint，如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS，請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係，請參見OSS地區和訪問網域名稱。
本文以從環境變數讀取存取憑證為例。如何配置訪問憑證，請參見配置訪問憑證。
要刪除檔案，您必須有oss:DeleteObject許可權。具體操作，請參見為RAM使用者授予自訂的權限原則。

版本控制下的刪除行為

版本控制下的刪除行為說明如下：

未指定versionId（臨時刪除）：
如果在未指定versionId的情況下執行刪除操作時，預設不會刪除Object的目前的版本，而是對目前的版本插入刪除標記（Delete Marker）。當執行GetObject操作時，OSS會檢測到目前的版本為刪除標記，並返回404 Not Found。此外，響應中會返回header：x-oss-delete-marker = true以及新產生的刪除標記的版本號碼x-oss-version-id。x-oss-delete-marker的值為true，表示與返回的x-oss-version-id對應的版本為刪除標記。
關於臨時刪除檔案後如何恢複檔案的更多資訊，請參見恢複檔案。
指定versionId（徹底刪除）：
如果在指定versionId的情況下執行刪除操作時，OSS會根據params中指定的versionId參數徹底刪除該版本。如果要刪除ID為“null”的版本，請在params參數中添加params['versionId'] = “null”。

範例程式碼

刪除單個檔案

指定versionId刪除Object

以下代碼用於指定versionId對Object進行徹底刪除：

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 // 儲存空間名稱
	objectName 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.")
	flag.StringVar(&objectName, "object", "", "The name of the object.")
}

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")
	}

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

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

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

	// 建立刪除對象的請求
	request := &oss.DeleteObjectRequest{
		Bucket:    oss.Ptr(bucketName),      // 儲存空間名稱
		Key:       oss.Ptr(objectName),      // 對象名稱
		VersionId: oss.Ptr("yourVersionId"), // 填寫實際的版本ID
	}

	// 執行刪除對象的操作並處理結果
	result, err := client.DeleteObject(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to delete object %v", err)
	}

	// 列印刪除對象的結果
	log.Printf("delete object result:%#v\n", result)
}

不指定versionId刪除Object

以下代碼用於不指定versionId對Object進行臨時刪除：

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 // 儲存空間名稱
	objectName 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.")
	flag.StringVar(&objectName, "object", "", "The name of the object.")
}

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")
	}

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

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

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

	// 建立刪除對象的請求
	request := &oss.DeleteObjectRequest{
		Bucket: oss.Ptr(bucketName), // 儲存空間名稱
		Key:    oss.Ptr(objectName), // 對象名稱
	}

	// 執行刪除對象的操作並處理結果
	result, err := client.DeleteObject(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to delete object %v", err)
	}

	// 列印刪除對象的結果
	log.Printf("delete object result:%#v\n", result)
}

刪除多個檔案

指定versionId刪除多個Object

以下代碼用於指定versionId對多個Object進行徹底刪除：

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)

	// 定義要刪除的對象列表
	DeleteObjects := []oss.DeleteObject{
		{Key: oss.Ptr("object1"), VersionId: oss.Ptr("versionId1")}, //填寫對象1的名稱和版本ID
		{Key: oss.Ptr("object2"), VersionId: oss.Ptr("versionId2")}, //填寫對象2的名稱和版本ID
		{Key: oss.Ptr("object3"), VersionId: oss.Ptr("versionId3")}, //填寫對象3的名稱和版本ID
	}

	// 建立刪除多個對象的請求
	request := &oss.DeleteMultipleObjectsRequest{
		Bucket:  oss.Ptr(bucketName), // 儲存空間名稱
		Objects: DeleteObjects,       // 要刪除的對象列表
	}

	// 執行刪除多個對象的操作並處理結果
	result, err := client.DeleteMultipleObjects(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to delete multiple objects %v", err)
	}

	// 列印刪除多個對象的結果
	log.Printf("delete multiple objects result:%#v\n", result)
}

不指定versionID刪除多個Object

以下代碼用於不指定versionId對多個Object進行臨時刪除：

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)

	// 定義要刪除的對象列表
	DeleteObjects := []oss.DeleteObject{
		{Key: oss.Ptr("object1")}, //填寫對象1的名稱
		{Key: oss.Ptr("object2")}, //填寫對象2的名稱
		{Key: oss.Ptr("object3")}, //填寫對象3的名稱
	}

	// 建立刪除多個對象的請求
	request := &oss.DeleteMultipleObjectsRequest{
		Bucket:  oss.Ptr(bucketName), // 儲存空間名稱
		Objects: DeleteObjects,       // 要刪除的對象列表
	}

	// 執行刪除多個對象的操作並處理結果
	result, err := client.DeleteMultipleObjects(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to delete multiple objects %v", err)
	}

	// 列印刪除多個對象的結果
	log.Printf("delete multiple objects result:%#v\n", result)
}

Object Storage Service：刪除檔案（Go SDK V2）