Merge pull request #277510 from laujan/patch-1

Update use-rest-api-programmatically.md

Author: prmerger-automator[bot]

articles/ai-services/translator/create-translator-resource.yml

@@ -7,7 +7,7 @@ metadata:
   author: laujan
   ms.author: lajanuar
   manager: nitinme
-  ms.date: 05/17/2024
+  ms.date: 06/06/2024
   ms.service: azure-ai-translator
   ms.topic: how-to
   ms.custom:
@@ -53,7 +53,7 @@ procedureSection:
           * Each subscription has a free tier.
           * The free tier has the same features and functionality as the paid plans and doesn't expire.
           * Only one free tier resource is available per subscription.
-          * Document Translation is supported in paid tier only. The Language Studio only supports the S1 or D3 instance tiers. If you just want to try Document Translation, select the Standard S1 instance tier.
+          * Document Translation is supported in paid tier only. The Language Studio supports the S1 and D3 instance tiers. If you just want to try Document Translation, select the Standard S1 instance tier.
       - |
         If you create a multi-service resource, the links at the bottom of the **Basics** tab provide technical documentation regarding the appropriate operation of the service.
       - |

articles/ai-services/translator/document-translation/how-to-guides/create-use-managed-identities.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: azure-ai-translator
 ms.custom: build-2023
 ms.topic: how-to
-ms.date: 02/12/2024
+ms.date: 06/06/2024
 ms.author: lajanuar
 ---
 
@@ -29,7 +29,7 @@ Managed identities for Azure resources are service principals that create a Micr
 >
 > * To use managed identities for Document Translation operations, you must [create your Translator resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) in a specific geographic Azure region such as **East US**. If your Translator resource region is set to **Global**, then you can't use managed identity for Document Translation. You can still use [Shared Access Signature tokens (SAS)](create-sas-tokens.md) for Document Translation.
 >
-> * Document Translation is **only** available in the S1 Standard Service Plan (Pay-as-you-go) or in the D3 Volume Discount Plan. _See_ [Azure AI services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
+> * Document Translation is is supported in the S1 Standard Service Plan (Pay-as-you-go) and C2, C3, C4, and D3 Volume Discount Plans. _See_ [Azure AI services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
 >
 
 ## Prerequisites

articles/ai-services/translator/document-translation/how-to-guides/use-rest-api-programmatically.md

@@ -6,7 +6,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: quickstart
-ms.date: 05/15/2024
+ms.date: 06/06/2024
 ms.author: lajanuar
 recommendations: false
 ms.devlang: csharp
@@ -24,7 +24,7 @@ ms.custom: mode-other, build-2023, devx-track-extended-java, devx-track-python
 >
 > * Typically, when you create an Azure AI resource in the Azure portal, you have the option to create a multi-service key or a single-service key. However, Document Translation is currently supported in the Translator (single-service) resource only, and is **not** included in the Azure AI services (multi-service) resource.
 >
-> * Document Translation is **only** supported in the S1 Standard Service Plan (Pay-as-you-go) or in the D3 Volume Discount Plan. _See_ [Azure AI services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
+> * Document Translation is supported in the S1 Standard Service Plan (Pay-as-you-go) and C2, C3, C4, and D3 Volume Discount Plans. _See_ [Azure AI services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
 >
 
 To get started, you need:

articles/ai-services/translator/document-translation/language-studio.md

@@ -6,7 +6,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: quickstart
-ms.date: 09/19/2023
+ms.date: 06/07/2024
 ms.author: lajanuar
 ms.custom: references_regions, build-2023
 recommendations: false
@@ -48,12 +48,12 @@ If you or an administrator have previously setup a Translator resource with a **
 >
 > * Document Translation is currently supported in the Translator (single-service) resource only, and is **not** included in the Azure AI services (multi-service) resource.
 >
-> * Document Translation is **only** supported in the S1 Standard Service Plan (Pay-as-you-go) or in the D3 Volume Discount Plan. *See* [Azure AI services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
+> * Document Translation is supported in the S1 Standard Service Plan (Pay-as-you-go) or in the D3 Volume Discount Plan. *See* [Azure AI services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
 >
 
 Document Translation in Language Studio requires the following resources:
 
-* An active [**Azure account**](https://azure.microsoft.com/free/cognitive-services/).  If you don't have one, you can [**create a free account**](https://azure.microsoft.com/free/).
+* An active [**Azure account**](https://azure.microsoft.com/free/cognitive-services/). If you don't have one, you can [**create a free account**](https://azure.microsoft.com/free/).
 
 * A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Azure AI services resource) with [**system-assigned managed identity**](how-to-guides/create-use-managed-identities.md#enable-a-system-assigned-managed-identity) enabled and a [**Storage Blob Data Contributor**](how-to-guides/create-use-managed-identities.md#grant-storage-account-access-for-your-translator-resource) role assigned. For more information, *see* [**Managed identities for Document Translation**](how-to-guides/create-use-managed-identities.md). Also, make sure the region and pricing sections are completed as follows:
 
@@ -63,7 +63,7 @@ Document Translation in Language Studio requires the following resources:
 
 * An [**Azure Blob Storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). An active Azure Blob Storage account is required to use Document Translation in the Language Studio.
 
-Now that you've completed the prerequisites, let's start translating documents!
+Now that you completed the prerequisites, let's start translating documents!
 
 ## Get started
 
@@ -91,7 +91,7 @@ At least one **source document** is required. You can download our [document tra
 
    :::image type="content" source="media/language-studio/initial-configuration.png" alt-text="Screenshot of the initial configuration page.":::
 
-1. In the **Job** section, choose the language to **Translate from** (source) or keep the default **Auto-detect language** and select the language to **Translate to** (target). You can select a maximum of 10 target languages. Once you've selected your source and target language(s), select **Next**:
+1. In the **Job** section, choose the language to **Translate from** (source) or keep the default **Auto-detect language** and select the language to **Translate to** (target). You can select a maximum of 10 target languages. Once you select your source and target languages, select **Next**:
 
    :::image type="content" source="media/language-studio/basic-information.png" alt-text="Screenshot of the language studio basic information page.":::
 
@@ -105,15 +105,15 @@ Your source and target files can be located in your local environment or your Az
 
  1. In the **files and destination** section, choose the files for translation by selecting the **Upload local files** button.
 
- 1. Next, select **➕ Add file(s)**, choose the file(s) for translation, then select **Next**:
+ 1. Next, select **➕ Add file(s)**, choose the files for translation, then select **Next**:
 
    :::image type="content" source="media/language-studio/upload-file.png" alt-text="Screenshot of the select files for translation page.":::
 
 #### [**Azure Blob Storage**](#tab/blob-storage)
 
 1. In the **files and destination** section, choose the files for translation by selecting the **Select for Blob storage** button.
 
-1. Next, choose your *source* **Blob container**, find and select the file(s) for translation, then select **Next**:
+1. Next, choose your *source* **Blob container**, find and select the files for translation, then select **Next**:
 
    :::image type="content" source="media/language-studio/select-blob-container.png" alt-text="Screenshot of select files from your blob container.":::
 
@@ -123,7 +123,7 @@ Your source and target files can be located in your local environment or your Az
 
 #### [**Local**](#tab/local-env)
 
-While still in the **files and destination** section, select **Download translated file(s)**. Once you have made your choice, select **Next**:
+While still in the **files and destination** section, select **Download translated file(s)**. Once you make your choice, select **Next**:
 
    :::image type="content" source="media/language-studio/target-file-upload.png" alt-text="Screenshot of the select destination for target files page.":::
 

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

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: azure-ai-translator
 ms.custom: devx-track-dotnet, devx-track-python
 ms.topic: quickstart
-ms.date: 02/12/2024
+ms.date: 06/06/2024
 ms.author: lajanuar
 zone_pivot_groups: programming-languages-document-sdk
 ---
@@ -22,7 +22,7 @@ Document Translation is a cloud-based feature of the [Azure AI Translator](../..
 > [!IMPORTANT]
 >
 > * Document Translation is currently supported in the Translator (single-service) resource only, and is **not** included in the Azure AI services (multi-service) resource.
-> * Document Translation is supported in paid tiers. The Language Studio only supports the S1 or D3 instance tiers. We suggest that you select Standard S1 to try Document Translation.  *See* [Azure AI services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
+> * Document Translation is supported in paid tiers. The Language Studio supports the S1 or D3 instance tiers. We suggest that you select Standard S1 to try Document Translation.  *See* [Azure AI services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
 > * Document Translation public preview releases provide early access to features that are in active development. Features, approaches, and processes may change, prior to General Availability (GA), based on user feedback.
 > * The public preview version of Document Translation client libraries default to REST API version [**2024-05-01**](/rest/api/aiservices/operation-groups?view=rest-aiservices-2024-02-29-preview&preserve-view=true).
 
@@ -32,7 +32,7 @@ To get started, you need:
 
 * An active [**Azure account**](https://azure.microsoft.com/free/cognitive-services/). If you don't have one, you can [**create a free account**](https://azure.microsoft.com/free/).
 
-* A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Azure AI services 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 or D3** or pricing tier.
+* A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Azure AI services 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 (Pay-as-you-go) or C2, C3, C4, or D3 Volume Discount Plans**.
 
 * An [**Azure Blob Storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). You'll [**create containers**](../../../../storage/blobs/storage-quickstart-blobs-portal.md#create-a-container) in your Azure Blob Storage account for your source and target files: