Merge pull request #34014 from wwlpublish/d7f48fcf1fdddbb9e0d5a1f5f194ad97-live

v-ccolin · web-flow · commit 1066577914dc · 2023-04-26T08:07:22.000+01:00
Modules/M03-work-with-blob-storage
diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json
@@ -21814,6 +21814,31 @@
       "source_path": "learn-pr/wwl-azure/explore-azure-blob-storage/8-summary.md",
       "redirect_url": "https://learn.microsoft.com/training/modules/explore-azure-blob-storage/7-summary",
       "redirect_document_id": false
+    },
+    {
+      "source_path": "learn-pr/wwl-azure/work-azure-blob-storage/3-develop-blob-storage-dotnet.md",
+      "redirect_url": "https://learn.microsoft.com/training/modules/work-azure-blob-storage/4-develop-blob-storage-dotnet",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "learn-pr/wwl-azure/work-azure-blob-storage/4-manage-container-properties-metadata-dotnet.md",
+      "redirect_url": "https://learn.microsoft.com/training/modules/work-azure-blob-storage/5-manage-container-properties-metadata-dotnet",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "learn-pr/wwl-azure/work-azure-blob-storage/5-set-retrieve-properties-metadata-rest.md",
+      "redirect_url": "https://learn.microsoft.com/training/modules/work-azure-blob-storage/6-set-retrieve-properties-metadata-rest",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "learn-pr/wwl-azure/work-azure-blob-storage/6-knowledge-check.md",
+      "redirect_url": "https://learn.microsoft.com/training/modules/work-azure-blob-storage/7-knowledge-check",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "learn-pr/wwl-azure/work-azure-blob-storage/7-summary.md",
+      "redirect_url": "https://learn.microsoft.com/training/modules/work-azure-blob-storage/8-summary",
+      "redirect_document_id": false
     }
   ]
 }
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/1-introduction.yml b/learn-pr/wwl-azure/work-azure-blob-storage/1-introduction.yml
@@ -4,7 +4,7 @@ title: Introduction
 metadata:
   title: Introduction
   description: "Introduction"
-  ms.date: 02/06/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: jeffko
   ms.topic: interactive-tutorial
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/2-blob-storage-client-library-overview.yml b/learn-pr/wwl-azure/work-azure-blob-storage/2-blob-storage-client-library-overview.yml
@@ -4,7 +4,7 @@ title: Explore Azure Blob storage client library
 metadata:
   title: Explore Azure Blob storage client library
   description: "Explore Azure Blob storage client library"
-  ms.date: 02/06/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: jeffko
   ms.topic: interactive-tutorial
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/3-create-client-object.yml b/learn-pr/wwl-azure/work-azure-blob-storage/3-create-client-object.yml
@@ -0,0 +1,14 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.work-azure-blob-storage.create-client-object
+title: Create a client object
+metadata:
+  title: Create a client object
+  description: "Create a client object"
+  ms.date: 04/26/2023
+  author: wwlpublish
+  ms.author: jeffko
+  ms.topic: interactive-tutorial
+  ms.prod: learning-azure
+durationInMinutes: 5
+content: |
+  [!include[](includes/3-create-client-object.md)]
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/4-develop-blob-storage-dotnet.yml b/learn-pr/wwl-azure/work-azure-blob-storage/4-develop-blob-storage-dotnet.yml
@@ -4,11 +4,11 @@ title: 'Exercise: Create Blob storage resources by using the .NET client library
 metadata:
   title: 'Exercise: Create Blob storage resources by using the .NET client library'
   description: "Exercise: Create Blob storage resources by using the .NET client library"
-  ms.date: 02/06/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: jeffko
   ms.topic: interactive-tutorial
   ms.prod: learning-azure
 durationInMinutes: 15
 content: |
-  [!include[](includes/3-develop-blob-storage-dotnet.md)]
+  [!include[](includes/4-develop-blob-storage-dotnet.md)]
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/5-manage-container-properties-metadata-dotnet.yml b/learn-pr/wwl-azure/work-azure-blob-storage/5-manage-container-properties-metadata-dotnet.yml
@@ -4,11 +4,11 @@ title: Manage container properties and metadata by using .NET
 metadata:
   title: Manage container properties and metadata by using .NET
   description: "Manage container properties and metadata by using .NET"
-  ms.date: 02/06/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: jeffko
   ms.topic: interactive-tutorial
   ms.prod: learning-azure
 durationInMinutes: 3
 content: |
-  [!include[](includes/4-manage-container-properties-metadata-dotnet.md)]
+  [!include[](includes/5-manage-container-properties-metadata-dotnet.md)]
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/6-set-retrieve-properties-metadata-rest.yml b/learn-pr/wwl-azure/work-azure-blob-storage/6-set-retrieve-properties-metadata-rest.yml
@@ -4,11 +4,11 @@ title: Set and retrieve properties and metadata for blob resources by using REST
 metadata:
   title: Set and retrieve properties and metadata for blob resources by using REST
   description: "Set and retrieve properties and metadata for blob resources by using REST"
-  ms.date: 02/06/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: jeffko
   ms.topic: interactive-tutorial
   ms.prod: learning-azure
 durationInMinutes: 3
 content: |
-  [!include[](includes/5-set-retrieve-properties-metadata-rest.md)]
+  [!include[](includes/6-set-retrieve-properties-metadata-rest.md)]
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/7-knowledge-check.yml b/learn-pr/wwl-azure/work-azure-blob-storage/7-knowledge-check.yml
@@ -4,7 +4,7 @@ title: Knowledge check
 metadata:
   title: Knowledge check
   description: "Knowledge check"
-  ms.date: 02/06/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: jeffko
   ms.topic: interactive-tutorial
@@ -17,21 +17,21 @@ quiz:
     choices:
     - content: "Last-Modified"
       isCorrect: true
-      explanation: "That's correct. Last-Modified is supported on both containers and blobs."
+      explanation: "Correct. Last-Modified is supported on both containers and blobs."
     - content: "Content-Length"
       isCorrect: false
-      explanation: "That's incorrect. Content-Length is only supported on blobs."
+      explanation: "Incorrect. Content-Length is only supported on blobs."
     - content: "Origin"
       isCorrect: false
-      explanation: "That's incorrect. Origin is only supported on blobs."
+      explanation: "Incorrect. Origin is only supported on blobs."
   - content: "Which of the following classes of the Azure Storage client library for .NET allows you to manipulate both Azure Storage containers and their blobs?"
     choices:
     - content: "BlobClient"
       isCorrect: false
-      explanation: "That's incorrect. The BlobClient class is limited to manipulating blobs."
+      explanation: "Incorrect. The BlobClient class is limited to manipulating blobs."
     - content: "BlobContainerClient"
       isCorrect: true
-      explanation: "That's correct. The BlobContainerClient can be used to manipulate both containers and blobs."
+      explanation: "Correct. The BlobContainerClient can be used to manipulate both containers and blobs."
     - content: "BlobUriBuilder"
       isCorrect: false
-      explanation: "That's incorrect. The BlobUriBuilder provides a way to modify the contents of a Uri instance to point to different Azure Storage resources like an account, container, or blob."
+      explanation: "Incorrect. The BlobUriBuilder provides a way to modify the contents of a Uri instance to point to different Azure Storage resources like an account, container, or blob."
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/8-summary.yml b/learn-pr/wwl-azure/work-azure-blob-storage/8-summary.yml
@@ -4,11 +4,11 @@ title: Summary
 metadata:
   title: Summary
   description: "Summary"
-  ms.date: 02/06/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: jeffko
   ms.topic: interactive-tutorial
   ms.prod: learning-azure
 durationInMinutes: 3
 content: |
-  [!include[](includes/7-summary.md)]
+  [!include[](includes/8-summary.md)]
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/includes/2-blob-storage-client-library-overview.md b/learn-pr/wwl-azure/work-azure-blob-storage/includes/2-blob-storage-client-library-overview.md
@@ -1,15 +1,19 @@
 
 The Azure Storage client libraries for .NET offer a convenient interface for making calls to Azure Storage. The latest version of the Azure Storage client library is version 12.x. Microsoft recommends using version 12.x for new applications.
 
-Below are the classes in the Azure.Storage.Blobs namespace and their purpose:
+The following table lists the basic classes, along with a brief description:
 
-Class | Description
--- | --
-`BlobClient` | The `BlobClient` allows you to manipulate Azure Storage blobs.
-`BlobClientOptions` | Provides the client configuration options for connecting to Azure Blob Storage.
-`BlobContainerClient` | The `BlobContainerClient` allows you to manipulate Azure Storage containers and their blobs.
-`BlobServiceClient` | The `BlobServiceClient` allows you to manipulate Azure Storage service resources and blob containers. The storage account provides the top-level namespace for the Blob service.
-`BlobUriBuilder` | The `BlobUriBuilder` class provides a convenient way to modify the contents of a Uri instance to point to different Azure Storage resources like an account, container, or blob.
+| Class | Description |
+|--|--|
+| `BlobServiceClient` | Represents the storage account, and provides operations to retrieve and configure account properties, and to work with blob containers in the storage account. |
+| `BlobContainerClient` | Represents a specific blob container, and provides operations to work with the container and the blobs within. |
+| `BlobClient` | Represents a specific blob, and provides general operations to work with the blob, including operations to upload, download, delete, and create snapshots. |
+| `AppendBlobClient` | Represents an append blob, and provides operations specific to append blobs, such as appending log data. |
+| `BlockBlobClient` | Represents a block blob, and provides operations specific to block blobs, such as staging and then committing blocks of data. |
 
+The following packages contain the classes used to work with Blob Storage data resources:
 
+* [Azure.Storage.Blobs](/dotnet/api/azure.storage.blobs): Contains the primary classes (client objects) that you can use to operate on the service, containers, and blobs.
+* [Azure.Storage.Blobs.Specialized](/dotnet/api/azure.storage.blobs.specialized): Contains classes that you can use to perform operations specific to a blob type, such as block blobs.
+* [Azure.Storage.Blobs.Models](/dotnet/api/azure.storage.blobs.models): All other utility classes, structures, and enumeration types.
 
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/includes/3-create-client-object.md b/learn-pr/wwl-azure/work-azure-blob-storage/includes/3-create-client-object.md
@@ -0,0 +1,80 @@
+
+
+Working with any Azure resource using the SDK begins with creating a client object. In this section, you learn how to create client objects to interact with the three types of resources in the storage service: storage accounts, containers, and blobs.
+
+When your application creates a client object, you pass a URI referencing the endpoint to the client constructor. You can construct the endpoint string manually, as shown in the examples in this article, or you can query for the endpoint at runtime using the Azure Storage management library.
+
+The code samples in this unit use [DefaultAzureCredential](/dotnet/api/azure.identity.defaultazurecredential) to authenticate to Azure via an Azure Active Directory (Azure AD) security principal. The authentication process includes obtaining an access token for authorization. This access token is passed as a credential when the client is instantiated, and the credential persists throughout the client lifetime. The Azure AD security principal requesting the token must be assigned an appropriate Azure RBAC role that grants access to blob data.
+
+## Create a BlobServiceClient object
+
+An authorized `BlobServiceClient` object allows your app to interact with resources at the storage account level. `BlobServiceClient` provides methods to retrieve and configure account properties, as well as list, create, and delete containers within the storage account. This client object is the starting point for interacting with resources in the storage account.
+
+The following example shows how to create a `BlobServiceClient` object:
+
+```csharp
+using Azure.Identity;
+using Azure.Storage.Blobs;
+
+public BlobServiceClient GetBlobServiceClient(string accountName)
+{
+    BlobServiceClient client = new(
+        new Uri($"https://{accountName}.blob.core.windows.net"),
+        new DefaultAzureCredential());
+
+    return client;
+}
+```
+
+## Create a BlobContainerClient object
+
+You can use a `BlobServiceClient` object to create a new `BlobContainerClient` object. A `BlobContainerClient` object allows you to interact with a specific container resource. `BlobContainerClient` provides methods to create, delete, or configure a container, and includes methods to list, upload, and delete the blobs within it.
+
+The following example shows how to create a container client from a `BlobServiceClient` object to interact with a specific container resource:
+
+```csharp
+public BlobContainerClient GetBlobContainerClient(
+    BlobServiceClient blobServiceClient,
+    string containerName)
+{
+    // Create the container client using the service client object
+    BlobContainerClient client = blobServiceClient.GetBlobContainerClient(containerName);
+    return client;
+}
+```
+
+If your work is narrowly scoped to a single container, you might choose to create a `BlobContainerClient` object directly without using `BlobServiceClient`.
+
+```csharp
+public BlobContainerClient GetBlobContainerClient(
+    string accountName,
+    string containerName,
+    BlobClientOptions clientOptions)
+{
+    // Append the container name to the end of the URI
+    BlobContainerClient client = new(
+        new Uri($"https://{accountName}.blob.core.windows.net/{containerName}"),
+        new DefaultAzureCredential(),
+        clientOptions);
+
+    return client;
+}
+```
+
+## Create a BlobClient object
+
+To interact with a specific blob resource, create a `BlobClient` object from a service client or container client. A `BlobClient` object allows you to interact with a specific blob resource.
+
+The following example shows how to create a blob client to interact with a specific blob resource:
+
+```csharp
+public BlobClient GetBlobClient(
+    BlobServiceClient blobServiceClient,
+    string containerName,
+    string blobName)
+{
+    BlobClient client =
+        blobServiceClient.GetBlobContainerClient(containerName).GetBlobClient(blobName);
+    return client;
+}
+```
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/includes/4-develop-blob-storage-dotnet.md b/learn-pr/wwl-azure/work-azure-blob-storage/includes/4-develop-blob-storage-dotnet.md
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/includes/5-manage-container-properties-metadata-dotnet.md b/learn-pr/wwl-azure/work-azure-blob-storage/includes/5-manage-container-properties-metadata-dotnet.md
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/includes/6-set-retrieve-properties-metadata-rest.md b/learn-pr/wwl-azure/work-azure-blob-storage/includes/6-set-retrieve-properties-metadata-rest.md
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/includes/8-summary.md b/learn-pr/wwl-azure/work-azure-blob-storage/includes/8-summary.md
diff --git a/learn-pr/wwl-azure/work-azure-blob-storage/index.yml b/learn-pr/wwl-azure/work-azure-blob-storage/index.yml
@@ -3,7 +3,7 @@ uid: learn.wwl.work-azure-blob-storage
 metadata:
   title: Work with Azure Blob storage
   description: "Learn how to use the Azure Blob storage client library to create and update Blob storage resources."
-  ms.date: 02/06/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: jeffko
   ms.topic: interactive-tutorial
@@ -31,6 +31,7 @@ subjects:
 units:
 - learn.wwl.work-azure-blob-storage.introduction
 - learn.wwl.work-azure-blob-storage.explore-client-library
+- learn.wwl.work-azure-blob-storage.create-client-object
 - learn.wwl.work-azure-blob-storage.exercise-create-resources-by-using-dotnet-client-library
 - learn.wwl.work-azure-blob-storage.manage-container-properties-metadata-dotnet
 - learn.wwl.work-azure-blob-storage.set-retrieve-properties-metadata-for-blob-resources-by-using-rest
