如何使用.NET SDK在存储容器间迁移Blob并保留版本ID

核心结论 #

Azure Blob存储的版本ID是系统自动生成的唯一标识符，与Blob的存储容器、创建时间强绑定，原生不支持复制或迁移Blob时保留原始版本ID。你当前使用的StartCopyFromUriAsync方法必然会生成新的版本ID，这是机制层面的限制。

替代实现方案 #

如果需要保留版本的关联关系（比如让原书签能对应到迁移后的版本），可以通过元数据映射的方式间接实现：

• 在复制每个Blob版本时，将原始版本ID写入目标Blob版本的元数据中
• 后续通过元数据查询，就能找到对应原始版本ID的目标Blob版本

修改后的代码示例 #

var sourceContainer = blobServiceClient.GetBlobContainerClient("files");
var targetContainer = blobServiceClient.GetBlobContainerClient("documents");

var sourceBlob = sourceContainer.GetBlobClient(blobName);
var targetBlob = targetContainer.GetBlobClient(blobName);

var sourceBlobVersions = sourceContainer.GetBlobs(BlobTraits.None, BlobStates.Version)
    .Where(a => a.Name == blobName)
    .OrderBy(a => DateTime.Parse(a.VersionId))
    .ToList();

foreach (var blobItem in sourceBlobVersions)
{
    var sourceVersionBlob = sourceBlob.WithVersion(blobItem.VersionId);
    // 获取源版本的原有元数据
    var sourceMetadata = (await sourceVersionBlob.GetPropertiesAsync()).Value.Metadata;
    // 添加原始版本ID到元数据
    sourceMetadata.Add("OriginalVersionId", blobItem.VersionId);
    
    var copyOptions = new BlobCopyFromUriOptions
    {
        Metadata = sourceMetadata
    };
    
    var operation = await targetBlob.StartCopyFromUriAsync(sourceVersionBlob.Uri, copyOptions);
    await operation.WaitForCompletionAsync(TimeSpan.FromMilliseconds(300), CancellationToken.None);
}

// 删除源Blob及所有版本
await sourceBlob.DeleteAsync(DeleteSnapshotsOption.IncludeSnapshots);

补充说明 #

1. 迁移完成后，若要通过原始版本ID查找目标Blob，可通过筛选元数据查询：

var targetVersions = targetContainer.GetBlobs(BlobTraits.Metadata, BlobStates.Version)
    .Where(b => b.Name == blobName && b.Metadata.TryGetValue("OriginalVersionId", out var id) && id == "原始版本ID")
    .ToList();

2. 若业务场景必须严格保留原始版本ID，目前没有官方原生支持——版本ID为系统自动生成，用户无法自定义指定。

内容的提问来源于stack exchange，提问作者Mike