Merge pull request #227622 from pauljewellmsft/pauljewell-blob-tags

Update blob tags articles for consistency

Author: v-dirichards

articles/storage/blobs/storage-blob-tags-java.md

@@ -24,13 +24,7 @@ To learn more about this feature along with known issues and limitations, see [M
 
 ## Set tags
 
-You can set and get index tags if your code has authorized access to blob data through one of the following mechanisms:
-- Azure AD built-in role assigned as [Storage Blob Data Owner](../../role-based-access-control/built-in-roles.md#storage-blob-data-owner) or higher
-- Azure RBAC action [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write](../../role-based-access-control/resource-provider-operations.md#microsoftstorage)
-- Shared Access Signature with permission to access the blob's tags (`t` permission)
-- Account key
-
-For more information, see [Setting blob index tags](storage-manage-find-blobs.md#setting-blob-index-tags).
+[!INCLUDE [storage-dev-guide-auth-set-blob-tags](../../../includes/storage-dev-guides/storage-dev-guide-auth-set-blob-tags.md)]
 
 You can set tags by using the following method:
 
@@ -46,13 +40,7 @@ You can delete all tags by passing an empty `Map` object into the `setTags` meth
 
 ## Get tags
 
-You can set and get index tags if your code has authorized access to blob data through one of the following mechanisms:
-- Azure AD built-in role assigned as [Storage Blob Data Owner](../../role-based-access-control/built-in-roles.md#storage-blob-data-owner) or higher
-- Azure RBAC action [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read](../../role-based-access-control/resource-provider-operations.md#microsoftstorage)
-- Shared Access Signature with permission to access the blob's tags (`t` permission)
-- Account key
-
-For more information, see [Getting and listing blob index tags](storage-manage-find-blobs.md#getting-and-listing-blob-index-tags).
+[!INCLUDE [storage-dev-guide-auth-get-blob-tags](../../../includes/storage-dev-guides/storage-dev-guide-auth-get-blob-tags.md)]
 
 You can get tags by using the following method: 
 
@@ -64,13 +52,7 @@ The following example shows how to retrieve and iterate over the blob's tags:
 
 ## Filter and find data with blob index tags
 
-You can use index tags to find and filter data if your code has authorized access to blob data through one of the following mechanisms:
-- Azure AD built-in role assigned as [Storage Blob Data Owner](../../role-based-access-control/built-in-roles.md#storage-blob-data-owner) or higher
-- Azure RBAC action [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action](../../role-based-access-control/resource-provider-operations.md#microsoftstorage)
-- Shared Access Signature with permission to find blobs by tags (`f` permission)
-- Account key
-
-For more information, see [Finding data using blob index tags](storage-manage-find-blobs.md#finding-data-using-blob-index-tags).
+[!INCLUDE [storage-dev-guide-auth-filter-blob-tags](../../../includes/storage-dev-guides/storage-dev-guide-auth-filter-blob-tags.md)]
 
 > [!NOTE]
 > You can't use index tags to retrieve previous versions. Tags for previous versions aren't passed to the blob index engine. For more information, see [Conditions and known issues](storage-manage-find-blobs.md#conditions-and-known-issues).

articles/storage/blobs/storage-blob-tags-javascript.md

@@ -24,11 +24,9 @@ To learn more about this feature along with known issues and limitations, see [M
 > [!NOTE]
 > The examples in this article assume that you've created a [BlobServiceClient](/javascript/api/@azure/storage-blob/blobserviceclient) object by using the guidance in the [Get started with Azure Blob Storage and JavaScript](storage-blob-javascript-get-started.md) article. Blobs in Azure Storage are organized into containers. Before you can upload a blob, you must first create a container. To learn how to create a container, see [Create a container in Azure Storage with JavaScript](storage-blob-container-create.md). 
 
-## Set and retrieve index tags
+## Set tags
 
-You can set and get index tags if your code has authorized access by using an account key or if your code uses a security principal that has been given the appropriate role assignments. For more information, see [Manage and find Azure Blob data with blob index tags](storage-manage-find-blobs.md).
-
-#### Set tags
+[!INCLUDE [storage-dev-guide-auth-set-blob-tags](../../../includes/storage-dev-guides/storage-dev-guide-auth-set-blob-tags.md)]
 
 To set tags at blob upload time, create a [BlobClient](storage-blob-javascript-get-started.md#create-a-blobclient-object) then use the following method:
 
@@ -63,7 +61,9 @@ You can delete all tags by passing an empty JSON object into the setTags method.
 | [Manage and find Azure Blob data with blob index tags](storage-manage-find-blobs.md) |
 | [Set Blob Tags](/rest/api/storageservices/set-blob-tags) (REST API) |
 
-#### Get tags
+## Get tags
+
+[!INCLUDE [storage-dev-guide-auth-get-blob-tags](../../../includes/storage-dev-guides/storage-dev-guide-auth-get-blob-tags.md)]
 
 To get tags, create a [BlobClient](storage-blob-javascript-get-started.md#create-a-blobclient-object) then use the following method: 
 
@@ -90,7 +90,7 @@ async function getTags(containerClient, blobName) {
 
 ## Filter and find data with blob index tags
 
-You can use index tags to find and filter data if your code has authorized access by using an account key or if your code uses a security principal that has been given the appropriate role assignments. For more information, see [Manage and find Azure Blob data with blob index tags](storage-manage-find-blobs.md).
+[!INCLUDE [storage-dev-guide-auth-filter-blob-tags](../../../includes/storage-dev-guides/storage-dev-guide-auth-filter-blob-tags.md)]
 
 > [!NOTE]
 > You can't use index tags to retrieve previous versions. Tags for previous versions aren't passed to the blob index engine. For more information, see [Conditions and known issues](storage-manage-find-blobs.md#conditions-and-known-issues).

articles/storage/blobs/storage-blob-tags-python.md

@@ -24,12 +24,7 @@ To learn more about this feature along with known issues and limitations, see [M
 
 ## Set tags
 
-You can set index tags if your code has authorized access to blob data through one of the following mechanisms:
-- Security principal that is assigned an Azure RBAC role with the [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write](../../role-based-access-control/resource-provider-operations.md#microsoftstorage) action. The [Storage Blob Data Owner](../../role-based-access-control/built-in-roles.md#storage-blob-data-owner) is a built-in role that includes this action.
-- Shared Access Signature with permission to access the blob's tags (`t` permission)
-- Account key
-
-For more information, see [Setting blob index tags](storage-manage-find-blobs.md#setting-blob-index-tags).
+[!INCLUDE [storage-dev-guide-auth-set-blob-tags](../../../includes/storage-dev-guides/storage-dev-guide-auth-set-blob-tags.md)]
 
 You can set tags by using the following method:
 
@@ -45,12 +40,7 @@ You can delete all tags by passing an empty `dict` object into the `set_blob_tag
 
 ## Get tags
 
-You can get index tags if your code has authorized access to blob data through one of the following mechanisms:
-- Security principal that is assigned an Azure RBAC role with the [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read](../../role-based-access-control/resource-provider-operations.md#microsoftstorage) action. The [Storage Blob Data Owner](../../role-based-access-control/built-in-roles.md#storage-blob-data-owner) is a built-in role that includes this action.
-- Shared Access Signature with permission to access the blob's tags (`t` permission)
-- Account key
-
-For more information, see [Getting and listing blob index tags](storage-manage-find-blobs.md#getting-and-listing-blob-index-tags).
+[!INCLUDE [storage-dev-guide-auth-get-blob-tags](../../../includes/storage-dev-guides/storage-dev-guide-auth-get-blob-tags.md)]
 
 You can get tags by using the following method: 
 
@@ -62,12 +52,7 @@ The following example shows how to retrieve and iterate over the blob's tags:
 
 ## Filter and find data with blob index tags
 
-You can use index tags to find and filter data if your code has authorized access to blob data through one of the following mechanisms:
-- Security principal that is assigned an Azure RBAC role with the [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action](../../role-based-access-control/resource-provider-operations.md#microsoftstorage) action. The [Storage Blob Data Owner](../../role-based-access-control/built-in-roles.md#storage-blob-data-owner) is a built-in role that includes this action.
-- Shared Access Signature with permission to find blobs by tags (`f` permission)
-- Account key
-
-For more information, see [Finding data using blob index tags](storage-manage-find-blobs.md#finding-data-using-blob-index-tags).
+[!INCLUDE [storage-dev-guide-auth-filter-blob-tags](../../../includes/storage-dev-guides/storage-dev-guide-auth-filter-blob-tags.md)]
 
 > [!NOTE]
 > You can't use index tags to retrieve previous versions. Tags for previous versions aren't passed to the blob index engine. For more information, see [Conditions and known issues](storage-manage-find-blobs.md#conditions-and-known-issues).

articles/storage/blobs/storage-blob-tags.md

@@ -21,11 +21,9 @@ Blob index tags categorize data in your storage account using key-value tag attr
 
 To learn more about this feature along with known issues and limitations, see [Manage and find Azure Blob data with blob index tags](storage-manage-find-blobs.md).
 
-## Set and retrieve index tags
+## Set tags
 
-You can set and get index tags if your code has authorized access by using an account key or if your code uses a security principal that has been given the appropriate role assignments. For more information, see [Manage and find Azure Blob data with blob index tags](storage-manage-find-blobs.md).
-
-#### Set tags
+[!INCLUDE [storage-dev-guide-auth-set-blob-tags](../../../includes/storage-dev-guides/storage-dev-guide-auth-set-blob-tags.md)]
 
 You can set tags by using either of the following methods:
 
@@ -62,7 +60,9 @@ await blobClient.SetTagsAsync(noTags);
 | [Manage and find Azure Blob data with blob index tags](storage-manage-find-blobs.md) |
 | [Set Blob Tags](/rest/api/storageservices/set-blob-tags) (REST API) |
 
-#### Get tags
+## Get tags
+
+[!INCLUDE [storage-dev-guide-auth-get-blob-tags](../../../includes/storage-dev-guides/storage-dev-guide-auth-get-blob-tags.md)]
 
 You can get tags by using either of the following methods: 
 
@@ -86,7 +86,7 @@ public static async Task GetTags(BlobClient blobClient)
 
 ## Filter and find data with blob index tags
 
-You can use index tags to find and filter data if your code has authorized access by using an account key or if your code uses a security principal that has been given the appropriate role assignments. For more information, see [Manage and find Azure Blob data with blob index tags](storage-manage-find-blobs.md).
+[!INCLUDE [storage-dev-guide-auth-filter-blob-tags](../../../includes/storage-dev-guides/storage-dev-guide-auth-filter-blob-tags.md)]
 
 > [!NOTE]
 > You can't use index tags to retrieve previous versions. Tags for previous versions aren't passed to the blob index engine. For more information, see [Conditions and known issues](storage-manage-find-blobs.md#conditions-and-known-issues).

includes/storage-dev-guides/storage-dev-guide-auth-filter-blob-tags.md

@@ -0,0 +1,18 @@
+---
+title: "include file"
+description: "include file"
+services: storage
+author: pauljewellmsft
+ms.service: storage
+ms.topic: include
+ms.date: 02/16/2023
+ms.author: pauljewell
+ms.custom: include file
+---
+
+You can use index tags to find and filter data if your code has authorized access to blob data through one of the following mechanisms:
+- Security principal that is assigned an Azure RBAC role with the [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action](../../articles/role-based-access-control/resource-provider-operations.md#microsoftstorage) action. The [Storage Blob Data Owner](../../articles/role-based-access-control/built-in-roles.md#storage-blob-data-owner) is a built-in role that includes this action.
+- Shared Access Signature (SAS) with permission to filter blobs by tags (`f` permission)
+- Account key
+
+For more information, see [Finding data using blob index tags](../../articles/storage/blobs/storage-manage-find-blobs.md#finding-data-using-blob-index-tags).

includes/storage-dev-guides/storage-dev-guide-auth-get-blob-tags.md

@@ -0,0 +1,18 @@
+---
+title: "include file"
+description: "include file"
+services: storage
+author: pauljewellmsft
+ms.service: storage
+ms.topic: include
+ms.date: 02/16/2023
+ms.author: pauljewell
+ms.custom: include file
+---
+
+You can get index tags if your code has authorized access to blob data through one of the following mechanisms:
+- Security principal that is assigned an Azure RBAC role with the [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read](../../articles/role-based-access-control/resource-provider-operations.md#microsoftstorage) action. The [Storage Blob Data Owner](../../articles/role-based-access-control/built-in-roles.md#storage-blob-data-owner) is a built-in role that includes this action.
+- Shared Access Signature (SAS) with permission to access the blob's tags (`t` permission)
+- Account key
+
+For more information, see [Getting and listing blob index tags](../../articles/storage/blobs/storage-manage-find-blobs.md#getting-and-listing-blob-index-tags).

includes/storage-dev-guides/storage-dev-guide-auth-set-blob-tags.md

@@ -0,0 +1,18 @@
+---
+title: "include file"
+description: "include file"
+services: storage
+author: pauljewellmsft
+ms.service: storage
+ms.topic: include
+ms.date: 02/16/2023
+ms.author: pauljewell
+ms.custom: include file
+---
+
+You can set index tags if your code has authorized access to blob data through one of the following mechanisms:
+- Security principal that is assigned an Azure RBAC role with the [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write](../../articles/role-based-access-control/resource-provider-operations.md#microsoftstorage) action. The [Storage Blob Data Owner](../../articles/role-based-access-control/built-in-roles.md#storage-blob-data-owner) is a built-in role that includes this action.
+- Shared Access Signature (SAS) with permission to access the blob's tags (`t` permission)
+- Account key
+
+For more information, see [Setting blob index tags](../../articles/storage/blobs/storage-manage-find-blobs.md#setting-blob-index-tags).