Merge pull request #227353 from tamram/tamram23-0214

add new article for blob versions in .NET (dev guide)

Author: v-regandowner

articles/storage/blobs/TOC.yml

@@ -625,6 +625,8 @@ items:
               href: storage-blob-container-lease.md
             - name: Create and manage snapshots
               href: snapshots-manage-dotnet.md
+            - name: Create and list blob versions
+              href: versions-manage-dotnet.md  
             - name: Generate a shared access signature (SAS)
               items:
               - name: Create a user delegation SAS

articles/storage/blobs/media/versioning-enable/portal-list-deleted-versions.png

@@ -3,8 +3,8 @@ title: Create and manage a blob snapshot in .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
-ms.author: pauljewell
 
+ms.author: pauljewell
 ms.service: storage
 ms.topic: how-to
 ms.date: 08/27/2020

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

@@ -8,8 +8,7 @@ ms.author: pauljewell
 
 ms.service: storage
 ms.topic: how-to
-ms.date: 03/28/2022
-
+ms.date: 02/14/2023
 ms.subservice: blobs
 ms.devlang: csharp
 ms.custom: devx-track-csharp, devguide-csharp
@@ -108,40 +107,11 @@ Blob name: FolderA/FolderB/FolderC/blob3.txt
 
 ### List blob versions or snapshots
 
-To list blob versions or snapshots, specify the [BlobStates](/dotnet/api/azure.storage.blobs.models.blobstates) parameter with the **Version** or **Snapshot** field. Versions and snapshots are listed from oldest to newest. 
+To list blob versions or snapshots, specify the [BlobStates](/dotnet/api/azure.storage.blobs.models.blobstates) parameter with the **Version** or **Snapshot** field. Versions and snapshots are listed from oldest to newest.
 
 The following code example shows how to list blob versions.
 
-```csharp
-private static void ListBlobVersions(BlobContainerClient blobContainerClient, 
-                                           string blobName)
-{
-    // Call the listing operation, specifying that blob versions are returned.
-    // Use the blob name as the prefix. 
-    var blobVersions = blobContainerClient.GetBlobs
-        (BlobTraits.None, BlobStates.Version, prefix: blobName)
-        .OrderByDescending(version => version.VersionId);
-
-    // Construct the URI for each blob version.
-    foreach (var version in blobVersions)
-    {
-        BlobUriBuilder blobUriBuilder = new BlobUriBuilder(blobContainerClient.Uri)
-        {
-            BlobName = version.Name,
-            VersionId = version.VersionId
-        };
-
-        if ((bool)version.IsLatestVersion.GetValueOrDefault())
-        {
-            Console.WriteLine("Current version: {0}", blobUriBuilder);
-        }
-        else
-        {
-            Console.WriteLine("Previous version: {0}", blobUriBuilder);
-        }
-    }
-}
-```
+:::code language="csharp" source="~/azure-storage-snippets/blobs/howto/dotnet/dotnet-v12/CRUD.cs" id="Snippet_ListBlobVersions":::
 
 ## Resources
 

articles/storage/blobs/storage-blobs-list.md

@@ -7,7 +7,7 @@ author: normesta
 
 ms.service: storage
 ms.topic: how-to
-ms.date: 01/25/2023
+ms.date: 02/14/2023
 ms.author: normesta
 ms.subservice: blobs
 ms.custom: devx-track-azurepowershell, devx-track-azurecli, engagement-fy23
@@ -107,6 +107,10 @@ To list a blob's versions in the Azure portal:
 
     :::image type="content" source="media/versioning-enable/portal-list-blob-versions.png" alt-text="Screenshot showing how to list blob versions in the Azure portal":::
 
+1. Toggle the **Show deleted versions** button to display soft-deleted versions. If blob soft delete is enabled for the storage account, then any soft-deleted versions that are still within the soft-delete retention interval will appear in the list.
+
+    :::image type="content" source="media/versioning-enable/portal-list-deleted-versions.png" alt-text="Screenshot showing how to list soft-deleted versions in Azure portal.":::
+
 # [PowerShell](#tab/powershell)
 
 To list a blob's versions with PowerShell, call the [Get-AzStorageBlob](/powershell/module/az.storage/get-azstorageblob) command with the `-IncludeVersion` parameter:
@@ -150,22 +154,6 @@ N/A
 
 ---
 
-## Modify a blob to trigger a new version
-
-The following code example shows how to trigger the creation of a new version with the Azure Storage client library for .NET, version [12.5.1](https://www.nuget.org/packages/Azure.Storage.Blobs/12.5.1) or later. Before running this example, make sure you have enabled versioning for your storage account.
-
-The example creates a block blob, and then updates the blob's metadata. Updating the blob's metadata triggers the creation of a new version. The example retrieves the initial version and the current version, and shows that only the current version includes the metadata.
-
-:::code language="csharp" source="~/azure-storage-snippets/blobs/howto/dotnet/dotnet-v12/CRUD.cs" id="Snippet_UpdateVersionedBlobMetadata":::
-
-## List blob versions with .NET
-
-To list blob versions or snapshots with the .NET v12 client library, specify the [BlobStates](/dotnet/api/azure.storage.blobs.models.blobstates) parameter with the **Version** field.
-
-The following code example shows how to list blobs version with the Azure Storage client library for .NET, version [12.5.1](https://www.nuget.org/packages/Azure.Storage.Blobs/12.5.1) or later. Before running this example, make sure you have enabled versioning for your storage account.
-
-:::code language="csharp" source="~/azure-storage-snippets/blobs/howto/dotnet/dotnet-v12/CRUD.cs" id="Snippet_ListBlobVersions":::
-
 ## Next steps
 
 - [Blob versioning](versioning-overview.md)