Merge pull request #7348 from laujan/uuf-476823-document-tranaslation

update document translation prerequisites

Author: prmerger-automator[bot]

articles/ai-services/translator/document-translation/quickstarts/client-library-sdks.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: azure-ai-translator
 ms.custom: devx-track-dotnet, devx-track-python
 ms.topic: quickstart
-ms.date: 04/14/2025
+ms.date: 09/29/2025
 ms.author: lajanuar
 zone_pivot_groups: programming-languages-document-sdk
 ---
@@ -33,11 +33,19 @@ To get started, you need:
 
 * A [**single-service Azure AI Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Azure AI Foundry resource). If you're planning on using the Document translation feature with [managed identity authorization](../how-to-guides/create-use-managed-identities.md), choose a geographic region such as **East US**. Select the **Standard S1 Standard Service Plan or C2, C3, C4, or D3 Volume Discount Plans**.
 
+    * After your resource deploys, select **Go to resource** and retrieve your key and endpoint.
+
+    * You need the key and endpoint from the resource to connect your application to the Azure AI Translator service. You paste your key and endpoint into the code later in the quickstart. You can find these values on the Azure portal **Keys and Endpoint** page.
+
+      :::image type="content" source="../media/document-translation-key-endpoint.png" alt-text="Screenshot to document translation key and endpoint location in the Azure portal.":::
+
 * An [**Azure Blob Storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). You'll [**create containers**](/azure/storage/blobs/storage-quickstart-blobs-portal#create-a-container) in your Azure Blob Storage account for your source and target files:
 
   * **Source container**. This container is where you upload your files for translation (required).
   * **Target container**. This container is where your translated files are stored (required).
 
+
+
 ### Storage container authorization
 
 You can choose one of the following options to authorize access to your Azure AI Translator resource.

articles/ai-services/translator/document-translation/quickstarts/rest-api.md

@@ -7,7 +7,7 @@ ms.author: lajanuar
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: quickstart
-ms.date: 07/17/2025
+ms.date: 09/29/2025
 ---
 
 # Get started: Document translation REST APIs
@@ -77,6 +77,23 @@ You need an active Azure subscription. If you don't have an Azure subscription,
     }
     ```
 
+### Storage container authorization
+
+You can choose one of the following options to authorize access to your Azure AI Translator resource.
+
+**✔️ Managed Identity**. A managed identity is a service principal that creates a Microsoft Entra identity and specific permissions for an Azure managed resource. Managed identities enable you to run your Azure AI Translator application without having to embed credentials in your code. Managed identities are a safer way to grant access to storage data and replace the requirement for you to include shared access signature tokens (SAS) with your source and target URLs.
+
+To learn more, *see* [Managed identities for Document translation](../how-to-guides/create-use-managed-identities.md).
+
+  :::image type="content" source="../media/managed-identity-rbac-flow.png" alt-text="Screenshot of managed identity flow (RBAC).":::
+
+**✔️ Shared Access Signature (SAS)**. A shared access signature is a URL that grants restricted access for a specified period of time to your Translator service. To use this method, you need to create Shared Access Signature (SAS) tokens for your source and target containers. The `sourceUrl`  and `targetUrl` must include a Shared Access Signature (SAS) token, appended as a query string. The token can be assigned to your container or specific blobs.
+
+* Your **source** container or blob must designate **read** and **list** access.
+* Your **target** container or blob must designate **write** and **list** access.
+
+To learn more, *see* [**Create SAS tokens**](../how-to-guides/create-sas-tokens.md).
+
 ### Build and run the POST request
 
 Before you run the **POST** request, replace `{your-document-translator-endpoint}` and `{your-key}` with the values from your Azure portal Azure AI Translator instance.