Merge pull request #271304 from pauljewellmsft/adls-dev

Add information note about multi-protocol access for Gen2

Author: v-dirichards

articles/storage/blobs/data-lake-storage-directory-file-acl-dotnet.md

@@ -41,9 +41,10 @@ using Azure.Storage.Files.DataLake;
 using Azure.Storage.Files.DataLake.Models;
 using Azure.Storage;
 using System.IO;
-
 ```
 
+[!INCLUDE [data-lake-storage-sdk-note](../../../includes/data-lake-storage-sdk-note.md)]
+
 ## Authorize access and connect to data resources
 
 To work with the code examples in this article, you need to create an authorized [DataLakeServiceClient](/dotnet/api/azure.storage.files.datalake.datalakeserviceclient) instance that represents the storage account. You can authorize a `DataLakeServiceClient` object using Microsoft Entra ID, an account access key, or a shared access signature (SAS).

articles/storage/blobs/data-lake-storage-directory-file-acl-java.md

@@ -45,6 +45,8 @@ import com.azure.storage.file.datalake.models.*;
 import com.azure.storage.file.datalake.options.*;
 ```
 
+[!INCLUDE [data-lake-storage-sdk-note](../../../includes/data-lake-storage-sdk-note.md)]
+
 ## Authorize access and connect to data resources
 
 To work with the code examples in this article, you need to create an authorized [DataLakeServiceClient](/java/api/com.azure.storage.file.datalake.datalakeserviceclient) instance that represents the storage account. You can authorize a `DataLakeServiceClient` object using Microsoft Entra ID, an account access key, or a shared access signature (SAS).

articles/storage/blobs/data-lake-storage-directory-file-acl-javascript.md

@@ -47,6 +47,8 @@ StorageSharedKeyCredential
 } = require("@azure/storage-file-datalake");
 ```
 
+[!INCLUDE [data-lake-storage-sdk-note](../../../includes/data-lake-storage-sdk-note.md)]
+
 ## Connect to the account
 
 To use the snippets in this article, you'll need to create a **DataLakeServiceClient** instance that represents the storage account.

articles/storage/blobs/data-lake-storage-directory-file-acl-python.md

@@ -49,6 +49,8 @@ from azure.storage.filedatalake import (
 from azure.identity import DefaultAzureCredential
 ```
 
+[!INCLUDE [data-lake-storage-sdk-note](../../../includes/data-lake-storage-sdk-note.md)]
+
 ## Authorize access and connect to data resources
 
 To work with the code examples in this article, you need to create an authorized [DataLakeServiceClient](/python/api/azure-storage-file-datalake/azure.storage.filedatalake.datalakeserviceclient) instance that represents the storage account. You can authorize a `DataLakeServiceClient` object using Microsoft Entra ID, an account access key, or a shared access signature (SAS).

includes/data-lake-storage-sdk-note.md

@@ -0,0 +1,15 @@
+---
+title: include file
+description: include file
+ms.service: azure-data-lake-storage
+author: pauljewellmsft
+ms.author: pauljewell
+ms.topic: include
+ms.date: 04/05/2024
+ms.custom: include file
+---
+
+> [!NOTE]
+> [Multi-protocol access on Data Lake Storage](../articles/storage/blobs/data-lake-storage-multi-protocol-access.md) enables applications to use both Blob APIs and Data Lake Storage Gen2 APIs to work with data in storage accounts with hierarchical namespace (HNS) enabled. When working with capabilities unique to Data Lake Storage Gen2, such as directory operations and ACLs, use the Data Lake Storage Gen2 APIs, as shown in this article.
+>
+> When choosing which APIs to use in a given scenario, consider the workload and the needs of your application, along with the [known issues](../articles/storage/blobs/data-lake-storage-known-issues.md#blob-storage-apis) and [impact of HNS on workloads and applications](../articles/storage/blobs/upgrade-to-data-lake-storage-gen2.md#impact-on-workloads-and-applications).