Merge pull request #234547 from pauljewellmsft/pauljewell-snapshot-version-rehydrate

Add samples for snapshots and versions

Author: v-dirichards

articles/storage/blobs/snapshots-manage-dotnet.md

@@ -1,5 +1,5 @@
 ---
-title: Create and manage a blob snapshot in .NET
+title: Create and manage a blob snapshot with .NET
 titleSuffix: Azure Storage
 description: Learn how to use the .NET client library to create a read-only snapshot of a blob to back up blob data at a given moment in time.
 author: pauljewellmsft
@@ -10,10 +10,10 @@ ms.topic: how-to
 ms.date: 08/27/2020
 ms.subservice: blobs
 ms.devlang: csharp
-ms.custom: devx-track-csharp
+ms.custom: devx-track-csharp, devguide-csharp
 ---
 
-# Create and manage a blob snapshot in .NET
+# Create and manage a blob snapshot with .NET
 
 A snapshot is a read-only version of a blob that's taken at a point in time. This article shows how to create and manage blob snapshots using the [Azure Storage client library for .NET](/dotnet/api/overview/azure/storage).
 
@@ -29,10 +29,15 @@ To create a snapshot of a block blob, use one of the following methods:
 The following code example shows how to create a snapshot. Include a reference to the [Azure.Identity](https://www.nuget.org/packages/azure.identity) library to use your Azure AD credentials to authorize requests to the service. For more information about using the [DefaultAzureCredential](/dotnet/api/azure.identity.defaultazurecredential) class to authorize a managed identity to access Azure Storage, see [Azure Identity client library for .NET](/dotnet/api/overview/azure/identity-readme).
 
 ```csharp
-private static async Task CreateBlockBlobSnapshot(string accountName, string containerName, string blobName, Stream data)
+private static async Task CreateBlockBlobSnapshot(
+    string accountName,
+    string containerName, 
+    string blobName,
+    Stream data)
 {
     const string blobServiceEndpointSuffix = ".blob.core.windows.net";
-    Uri containerUri = new Uri("https://" + accountName + blobServiceEndpointSuffix + "/" + containerName);
+    Uri containerUri = 
+        new Uri("https://" + accountName + blobServiceEndpointSuffix + "/" + containerName);
 
     // Get a container client object and create the container.
     BlobContainerClient containerClient = new BlobContainerClient(containerUri,
@@ -89,12 +94,24 @@ The following code example shows how to delete a blob and its snapshots in .NET,
 await blobClient.DeleteIfExistsAsync(DeleteSnapshotsOption.IncludeSnapshots, null, default);
 ```
 
-## Next steps
+## Copy a blob snapshot over the base blob
 
-- [Blob snapshots](snapshots-overview.md)
-- [Blob versions](versioning-overview.md)
-- [Soft delete for blobs](./soft-delete-blob-overview.md)
+You can perform a copy operation to promote a snapshot over its base blob, as long as the base blob is in an online tier (hot or cool). The snapshot remains, but its destination is overwritten with a copy that can be read and written to.
+
+The following code example shows how to copy a blob snapshot over the base blob:
+
+:::code language="csharp" source="~/azure-storage-snippets/blobs/howto/dotnet/BlobDevGuideBlobs/CopySnapshot.cs" id="Snippet_CopySnapshot":::
 
 ## Resources
 
-For related code samples using deprecated .NET version 11.x SDKs, see [Code samples using .NET version 11.x](blob-v11-samples-dotnet.md#create-a-snapshot).
+To learn more about managing blob snapshots using the Azure Blob Storage client library for .NET, see the following resources.
+
+For related code samples using deprecated .NET version 11.x SDKs, see [Code samples using .NET version 11.x](blob-v11-samples-dotnet.md#create-a-snapshot).
+
+[!INCLUDE [storage-dev-guide-resources-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-resources-dotnet.md)]
+
+### See also
+
+- [Blob snapshots](snapshots-overview.md)
+- [Blob versions](versioning-overview.md)
+- [Soft delete for blobs](./soft-delete-blob-overview.md)

articles/storage/blobs/versions-manage-dotnet.md

@@ -35,7 +35,21 @@ The following code example shows how to list blob versions.
 
 :::code language="csharp" source="~/azure-storage-snippets/blobs/howto/dotnet/dotnet-v12/CRUD.cs" id="Snippet_ListBlobVersions":::
 
-## See also
+## Copy a previous blob version over the base blob
+
+You can perform a copy operation to promote a version over its base blob, as long as the base blob is in an online tier (hot or cool). The version remains, but its destination is overwritten with a copy that can be read and written to.
+
+The following code example shows how to copy a blob version over the base blob:
+
+:::code language="csharp" source="~/azure-storage-snippets/blobs/howto/dotnet/BlobDevGuideBlobs/CopyVersion.cs" id="Snippet_CopyVersion":::
+
+## Resources
+
+To learn more about managing blob versions using the Azure Blob Storage client library for .NET, see the following resources.
+
+[!INCLUDE [storage-dev-guide-resources-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-resources-dotnet.md)]
+
+### See also
 
 - [Blob versioning](versioning-overview.md)
 - [Enable and manage blob versioning](versioning-enable.md)