使用 Go 刪除和還原 Blob

發行項
06/13/2024

本文說明如何使用適用於 Go 的 Azure 儲存體用戶端模組來刪除 Blob。如果您已啟用 Blob 的虛刪除，則可以在保留期間還原已刪除的 Blob。

必要條件

Azure 訂用帳戶 - 建立免費帳戶
Azure 儲存體帳戶 - 建立儲存體帳戶
Go 1.18+

設定您的環境

如果您沒有現有的專案，本節說明如何設定專案以使用適用於 Go 的 Azure Blob 儲存體客戶端模組。這些步驟包括模組安裝、新增 import 路徑，以及建立授權的客戶端物件。如需詳細資訊，請參閱開始使用 Azure Blob 儲存體和 Go。

安裝模組

使用下列命令安裝 azblob 模組：

go get github.com/Azure/azure-sdk-for-go/sdk/storage/azblob

若要使用 Microsoft Entra ID 進行驗證（建議），請使用下列命令安裝 azidentity 模組：

go get github.com/Azure/azure-sdk-for-go/sdk/azidentity

新增匯入路徑

在您的程式代碼檔案中，新增下列匯入路徑：

import (
    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/storage/azblob"
)

本文中的某些程式代碼範例可能需要其他匯入路徑。如需特定詳細數據和範例使用方式，請參閱程式代碼範例。

建立用戶端物件

若要將應用程式連線到 Blob 記憶體，請使用 azblob 建立客戶端物件。NewClient。下列範例示範如何使用來建立客戶端物件 DefaultAzureCredential 以進行授權：

func getServiceClientTokenCredential(accountURL string) *azblob.Client {
    // Create a new service client with token credential
    credential, err := azidentity.NewDefaultAzureCredential(nil)
    handleError(err)

    client, err := azblob.NewClient(accountURL, credential, nil)
    handleError(err)

    return client
}

授權

授權機制必須具有刪除 Blob 的必要許可權，或還原虛刪除的 Blob。如需具有 Microsoft Entra ID 的授權（建議），您需要 Azure RBAC 內建角色 記憶體 Blob 數據參與者 或更高版本。若要深入瞭解，請參閱刪除 Blob （REST API）和取消刪除 Blob （REST API）的授權指引。

刪除 Blob

若要刪除 Blob，請呼叫下列方法：

DeleteBlob

下列範例會刪除 blob：

func deleteBlob(client *azblob.Client, containerName string, blobName string) {
    // Delete the blob
    _, err := client.DeleteBlob(context.TODO(), containerName, blobName, nil)
    handleError(err)
}

如果 Blob 具有任何相關聯的快照集，您必須刪除其所有快照集，才能刪除 Blob。下列範例會刪除 Blob 及其快照集：

func deleteBlobWithSnapshots(client *azblob.Client, containerName string, blobName string) {
    // Delete the blob and its snapshots
    _, err := client.DeleteBlob(context.TODO(), containerName, blobName, &blob.DeleteOptions{
        DeleteSnapshots: to.Ptr(blob.DeleteSnapshotsOptionTypeInclude),
    })
    handleError(err)
}

若要只刪除快照集，而不是 Blob 本身，您可以將值DeleteSnapshotsOptionTypeOnly傳遞至 DeleteSnapshots 參數。

還原已刪除的 Blob

Blob 虛刪除可保護個別的 Blob 及其版本、快照集和中繼資料，將刪除的資料保留在系統中一段指定時間，避免不小心刪除或覆寫資料。在保留期間內，您可以在刪除時將 Blob 還原至其狀態。保留期間到期之後，Blob 會永久刪除。如需關於 Blob 虛刪除的詳細資訊，請參閱 Blob 的虛刪除。

您可以使用 Azure 儲存體用戶端程式庫來還原已虛刪除的 Blob 或快照集。

還原虛刪除 Blob 的方式，取決於您的儲存體帳戶是否已啟用 Blob 版本設定。如需 Blob 版本設定的詳細資訊，請參閱 Blob 版本設定。視您的情節而定，請參閱下列其中一個區段：

未啟用 Blob 版本設定
已啟用 Blob 版本設定

在停用版本控制時還原虛刪除的物件

若要在停用版本設定時還原已刪除的 Blob，請呼叫下列方法：

UndeleteBlob

此方法會還原虛刪除 Blob 的內容和中繼資料，以及任何相關聯的虛刪除快照集。針對未刪除的 Blob 呼叫這個方法，不會有任何作用。

func restoreDeletedBlob(client *azblob.Client, containerName string, blobName string) {
    // Reference the blob as a client object
    blobClient := client.ServiceClient().NewContainerClient(containerName).NewBlobClient(blobName)

    // Restore the deleted blob
    _, err := blobClient.Undelete(context.TODO(), &blob.UndeleteOptions{})
    handleError(err)
}

在停用版本設定時，還原虛刪除的物件

若儲存體帳戶設定為啟用 Blob 版本設定，則刪除 Blob 會導致目前版本的 Blob 變成舊版。若要在啟用版本設定時還原已虛刪除的 Blob，請透過基底 Blob 複製舊版。您可以使用下列方法：

StartCopyFromURL

下列程式代碼範例會識別已刪除的 Blob 版本，並藉由將它複製到基底 Blob 來還原該版本：

func restoreDeletedBlobVersion(client *azblob.Client, containerName string, blobName string, versionID string) {
    // Reference the blob as a client object
    baseBlobClient := client.ServiceClient().NewContainerClient(containerName).NewBlobClient(blobName)

    blobVersionClient, err := baseBlobClient.WithVersionID(versionID)
    handleError(err)

    // Restore the blob version by copying it to the base blob
    _, err = baseBlobClient.StartCopyFromURL(context.TODO(), blobVersionClient.URL(), nil)
    handleError(err)
}

注意

本指南中的程式碼範例旨在協助您開始使用 Azure Blob 儲存體和 Go。您應該修改錯誤處理和 Context 值，以符合應用程式的需求。

資源

若要深入瞭解如何使用 go 的 Azure Blob 儲存體用戶端模組來刪除 Blob 和還原已刪除的 Blob，請參閱下列資源。

程式碼範例

檢視本文中的程式碼範例（GitHub）

REST API 操作

Azure SDK for Go 包含以 Azure REST API 為基礎的連結庫，可讓您透過熟悉的 Go 架構與 REST API 作業互動。用於刪除 Blob 和還原已刪除 Blob 的用戶端程式庫方法，會使用下列 REST API 作業：

刪除 Blob (REST API)
取消刪除 blob (REST API)

共用方式為