Merge pull request #231130 from laujan/70755-update-glossary-with-mi

update code sample to reflect managed identity

Author: prmerger-automator[bot]

articles/cognitive-services/Translator/document-translation/how-to-guides/create-use-glossaries.md

@@ -5,7 +5,7 @@ ms.topic: how-to
 manager: nitinme
 ms.author: lajanuar
 author: laujan
-ms.date: 03/14/2023
+ms.date: 03/16/2023
 ---
 
 # Use glossaries with Document Translation
@@ -20,6 +20,9 @@ A glossary is a list of terms with definitions that you create for the Document
 
 ## Create, upload, and use a glossary file
 
+> [!NOTE]
+> The following example uses an enabled [**system-assigned managed identity**](create-use-managed-identities.md#enable-a-system-assigned-managed-identity) and a [**Storage Blob Data Contributor**](create-use-managed-identities.md#grant-access-to-your-storage-account) role assignment for authentication. For more information, *see* [**Managed identities for Document Translation**](./create-use-managed-identities.md).
+
 1. **Create your glossary file.** Create a file in a supported format (preferably tab-separated values) that contains all the terms and phrases you want to use in your translation.
 
    To check if your file format is supported, *see* [Get supported glossary formats](../reference/get-supported-glossary-formats.md).
@@ -43,7 +46,7 @@ A glossary is a list of terms with definitions that you create for the Document
 
 1. **Specify your glossary in the translation request.** Include the **`glossary URL`**, **`format`**, and **`version`** in your **`POST`** request:
 
-      :::code language="json" source="../../../../../cognitive-services-rest-samples/curl/Translator/translate-with-glossary.json" range="1-23" highlight="13-15":::
+      :::code language="json" source="../../../../../cognitive-services-rest-samples/curl/Translator/translate-with-glossary.json" range="1-23" highlight="13-14":::
 
 ### Case sensitivity
 

articles/cognitive-services/Translator/document-translation/how-to-guides/create-use-managed-identities.md

@@ -7,36 +7,35 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: how-to
-ms.date: 02/09/2023
+ms.date: 03/16/2023
 ms.author: lajanuar
 ---
 
 # Managed identities for Document Translation
 
-:::image type="content" source="../media/managed-identity-rbac-flow.png" alt-text="Screenshot of managed identity flow (RBAC).":::
-
-> [!IMPORTANT]
->
-> * Currently, Document Translation doesn't support managed identity in the global region. If you intend to use managed identities for Document Translation operations, [create your Translator resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) in a non-global Azure region.
->
-> * Document Translation is **only** available in the S1 Standard Service Plan (Pay-as-you-go) or in the D3 Volume Discount Plan. _See_ [Cognitive Services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
->
-
 Managed identities for Azure resources are service principals that create an Azure Active Directory (Azure AD) identity and specific permissions for Azure managed resources:
 
+   :::image type="content" source="../media/managed-identity-rbac-flow.png" alt-text="Screenshot of managed identity flow (RBAC).":::
+
 * You can use managed identities to grant access to any resource that supports Azure AD authentication, including your own applications. Managed identities eliminate the need for you to include shared access signature tokens (SAS) with your HTTP requests.
 
 * To grant access to an Azure resource, assign an Azure role to a managed identity using [Azure role-based access control (`Azure RBAC`)](../../../../role-based-access-control/overview.md).
 
 * There's no added cost to use managed identities in Azure.
 
-> [!TIP]
+
+
+
+> [!IMPORTANT]
 >
 > * When using managed identities, don't include a SAS token URL with your HTTP requests—your requests will fail.
 >
+> * Currently, Document Translation doesn't support managed identity in the global region. If you intend to use managed identities for Document Translation operations, [create your Translator resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) in a non-global Azure region.
+>
+> * Document Translation is **only** available in the S1 Standard Service Plan (Pay-as-you-go) or in the D3 Volume Discount Plan. _See_ [Cognitive Services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
+>
 > * Managed identities are a safer way to grant access to data without having SAS tokens included with your HTTP requests.
 
-
 ## Prerequisites
 
 To get started, you need:
@@ -130,7 +129,7 @@ The **Storage Blob Data Contributor** role gives Translator (represented by the
 
 * With managed identity and `Azure RBAC`, you no longer need to include SAS URLs.
 
-* If successful, the POST method returns a `202 Accepted`  response code and the batch request is created by the service. 
+* If successful, the POST method returns a `202 Accepted` response code and the service creates a batch request.
 
 * The translated documents appear in your target container.