使用 .NET 删除和还原 Blob

项目
10/18/2023

本文介绍了如何使用适用于 .NET 的 Azure 存储客户端库删除 Blob。如果已启用 Blob 软删除，则可以在保持期内还原已删除的 Blob。

先决条件

本文假设已经设置了项目来使用适用于 .NET 的 Azure Blob 存储客户端库。要了解有关设置项目的信息，包括包安装、添加 using 指令和创建授权客户端对象，请参阅开始使用 Azure Blob 存储和 .NET。
授权机制必须具有删除 blob 或还原软删除 blob 的权限。若要了解详细信息，请参阅以下 REST API 操作的授权指南：
- 删除 Blob
- 取消删除 Blob

删除 Blob

若要删除 Blob，请调用以下任一方法：

下面的示例删除 Blob：

public static async Task DeleteBlobAsync(BlobClient blob)
{
    await blob.DeleteAsync();
}

如果 Blob 具有任何关联的快照，则必须删除其所有快照才能删除该 Blob。以下示例删除一个 Blob 及其快照：

public static async Task DeleteBlobSnapshotsAsync(BlobClient blob)
{
    // Delete a blob and all of its snapshots
    await blob.DeleteAsync(snapshotsOption: DeleteSnapshotsOption.IncludeSnapshots);

    // Delete only the blob's snapshots
    //await blob.DeleteAsync(snapshotsOption: DeleteSnapshotsOption.OnlySnapshots);
}

若要仅删除快照，而不删除 Blob 本身，可以传递参数 DeleteSnapshotsOption.OnlySnapshots。

还原已删除的 Blob

Blob 软删除会在系统中将已删除的数据保留指定的一段时间，可以在意外删除或覆盖单个 Blob 及其版本、快照和元数据时提供保护。在保留期内，可以将 Blob 还原到它在删除时的状态。在指定的保留期已过后，Blob 将永久被删除。有关 Blob 软删除的详细信息，请参阅 Blob 的软删除。

可以使用 Azure 存储客户端库来还原软删除的 Blob 或快照。

还原软删除的 Blob 的方式取决于存储帐户是否启用了 Blob 版本控制。有关 Blob 版本控制的详细信息，请参阅 Blob 版本控制。请根据你的情况，查看以下部分之一：

未启用 Blob 版本控制
已启用 Blob 版本控制

禁用版本控制时还原软删除的对象

若要在未启用版本控制时还原删除的 Blob，请调用以下任一方法：

这些方法可还原软删除的 blob 以及与之关联的所有已删除快照。对尚未删除的 Blob 调用以下任一方法均不起作用。以下示例在容器中还原所有软删除的 Blob 及其快照：

public static async Task RestoreBlobsAsync(BlobContainerClient container)
{
    foreach (BlobItem blob in container.GetBlobs(BlobTraits.None, BlobStates.Deleted))
    {
        await container.GetBlockBlobClient(blob.Name).UndeleteAsync();
    }
}

若要还原特定的软删除快照，请先对基础 Blob 调用 Undelete 或 UndeleteAsync，然后将所需快照复制到基础 Blob。以下示例将块 Blob 还原到其最近生成的快照：

public static async Task RestoreSnapshotsAsync(
    BlobContainerClient container,
    BlobClient blob)
{
    // Restore the deleted blob
    await blob.UndeleteAsync();

    // List blobs in this container that match prefix
    // Include snapshots in listing
    Pageable<BlobItem> blobItems = container.GetBlobs(
        BlobTraits.None,
        BlobStates.Snapshots,
        prefix: blob.Name);

    // Get the URI for the most recent snapshot
    BlobUriBuilder blobSnapshotUri = new BlobUriBuilder(blob.Uri)
    {
        Snapshot = blobItems
            .OrderByDescending(snapshot => snapshot.Snapshot)
            .ElementAtOrDefault(0)?.Snapshot
    };

    // Restore the most recent snapshot by copying it to the blob
    await blob.StartCopyFromUriAsync(blobSnapshotUri.ToUri());
}

启用版本控制时还原软删除的 Blob

如果将存储帐户配置为启用 blob 版本控制，则删除 blob 会导致 blob 的当前版本成为以前的版本。若要在启用了版本控制的情况下还原软删除的 Blob，请将前一个版本复制到基础 Blob。可以使用以下方法之一：

下面的代码示例演示如何获取已删除 blob 的最新版本，并通过将其复制到基本 blob 来还原最新版本：

public static void RestoreBlobWithVersioning(
    BlobContainerClient container,
    BlobClient blob)
{
    // List blobs in this container that match prefix
    // Include versions in listing
    Pageable<BlobItem> blobItems = container.GetBlobs(
        BlobTraits.None,
        BlobStates.Version,
        prefix: blob.Name);

    // Get the URI for the most recent version
    BlobUriBuilder blobVersionUri = new BlobUriBuilder(blob.Uri)
    {
        VersionId = blobItems.
            OrderByDescending(version => version.VersionId).
            ElementAtOrDefault(0)?.VersionId
    };

    // Restore the most recently generated version by copying it to the base blob
    blob.StartCopyFromUri(blobVersionUri.ToUri());
}

资源

若要详细了解如何使用适用于 .NET 的 Azure Blob 存储客户端库来删除 Blob 和还原已删除的 Blob，请参阅以下资源。

REST API 操作

Azure SDK for .NET 包含基于 Azure REST API 而生成的库，允许你通过熟悉的 .NET 范例与 REST API 操作进行交互。用于删除 Blob 和还原已删除 Blob 的客户端库方法使用以下 REST API 操作：

Share via