Merge pull request #250496 from laujan/114210-github-issue-translator-authentication

update authentication guidance

Author: prmerger-automator[bot]

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

@@ -1,15 +1,15 @@
 ---
 title: Create a Translator resource
 titleSuffix: Azure AI services
-description: This article shows you how to create an Azure AI Translator resource and retrieve yourgit  key and endpoint URL.
+description: This article shows you how to create an Azure AI Translator resource.
 services: cognitive-services
 author: laujan
 ms.author: lajanuar
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: how-to
-ms.date: 07/18/2023
+ms.date: 09/06/2023
 ---
 
 # Create a Translator resource
@@ -46,7 +46,7 @@ The Translator service can be accessed through two different resource types:
    * 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 is available per subscription.
-   * Document Translation is supported in paid tiers. The Language Studio only supports the S1 or D3 instance tiers. We suggest you select the Standard S1 instance tier to try Document Translation. 
+   * Document Translation is supported in paid tiers. The Language Studio only supports the S1 or D3 instance tiers. We suggest you select the Standard S1 instance tier to try Document Translation.
 
 1. If you've created a multi-service resource, you need to confirm more usage details via the check boxes.
 
@@ -72,6 +72,24 @@ All Azure AI services API requests require an endpoint URL and a read-only key f
 
 :::image type="content" source="media/keys-and-endpoint-resource.png" alt-text="Get key and endpoint.":::
 
+## Create a Text Translation client
+
+Text Translation supports both [global and regional endpoints](#complete-your-project-and-instance-details). Once you have your [authentication keys](#authentication-keys-and-endpoint-url), you need to create an instance of the `TextTranslationClient`, using an `AzureKeyCredential` for authentication, to interact with the Text Translation service:
+
+* To create a `TextTranslationClient` using a global resource endpoint, you need your resource **API key**:
+
+    ```bash
+      AzureKeyCredential credential = new('<apiKey>');
+      TextTranslationClient client = new(credential);
+    ```
+
+* To create a `TextTranslationClient` using a regional resource endpoint, you need your resource **API key** and the name of the **region** where your resource is located:
+
+    ```bash
+     AzureKeyCredential credential = new('<apiKey>');
+     TextTranslationClient client = new(credential, '<region>');
+    ```
+
 ## How to delete a  resource or resource group
 
 > [!WARNING]

articles/ai-services/translator/includes/text-translation-sdk/csharp.md

@@ -71,9 +71,10 @@ To interact with the Translator service using the client library, you need to cr
 
 **Translate text**
 
-```csharp
+  > [!NOTE]
+  > In this example we are using the global endpoint. If you're using a regional endpoint, see [Create a Text Translation client](../../create-translator-resource.md#create-a-text-translation-client).
 
-// Using the global endpoint (default)
+```csharp
 
 using Azure;
 using Azure.AI.Translation.Text;

articles/ai-services/translator/includes/text-translation-sdk/java.md

@@ -113,6 +113,9 @@ For this quickstart, we use the Gradle build automation tool to create and run t
 
 To interact with the Translator service using the client library, you need to create an instance of the `TextTranslationClient`class. To do so, create an `AzureKeyCredential` with your `key` from the Azure portal and a `TextTranslationClient` instance with the `AzureKeyCredential`. The authentication varies slightly depending on whether your resource uses the regional or global endpoint. For this project, authenticate using the global endpoint. For more information about using a regional endpoint, _see_ [Translator text sdks](../../text-sdk-overview.md#3-authenticate-the-client).
 
+  > [!NOTE]
+  > In this example we are using the global endpoint. If you're using a regional endpoint, see [Create a Text Translation client](../../create-translator-resource.md#create-a-text-translation-client).
+
 ```java
 import java.util.List;
 import java.util.ArrayList;

articles/ai-services/translator/includes/text-translation-sdk/javascript.md

@@ -77,6 +77,9 @@ To interact with the Translator service using the client library, you need to cr
 
 **Translate text**
 
+  > [!NOTE]
+  > In this example we are using a regional endpoint. If you're using the global endpoint, see [Create a Text Translation client](../../create-translator-resource.md#create-a-text-translation-client).
+
 ```javascript
 const TextTranslationClient = require("@azure-rest/ai-translation-text").default
 

articles/ai-services/translator/includes/text-translation-sdk/python.md

@@ -41,6 +41,9 @@ To interact with the Translator service using the client library, you need to cr
 
 **Translate text**
 
+  > [!NOTE]
+  > In this example we are using a regional endpoint. If you're using the global endpoint, see [Create a Text Translation client](../../create-translator-resource.md#create-a-text-translation-client).
+
 ```python
 from azure.ai.translation.text import TextTranslationClient, TranslatorCredential
 from azure.ai.translation.text.models import InputTextItem

articles/ai-services/translator/quickstart-text-rest-api.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: quickstart
-ms.date: 07/18/2023
+ms.date: 09/06/2023
 ms.author: lajanuar
 ms.devlang: csharp, golang, java, javascript, python
 ms.custom: devx-track-python
@@ -41,7 +41,7 @@ You need an active Azure subscription. If you don't have an Azure subscription,
     > * For this quickstart it is recommended that you use a Translator text single-service global resource.
     > * With a single-service global resource you'll include one authorization header (**Ocp-Apim-Subscription-key**) with the REST API request. The value for Ocp-Apim-Subscription-key is your Azure secret key for your Translator Text subscription.
     > * If you choose to use an Azure AI multi-service or regional Translator resource, two authentication headers will be required: (**Ocp-Api-Subscription-Key** and **Ocp-Apim-Subscription-Region**). The value for Ocp-Apim-Subscription-Region is the region associated with your subscription.
-    > * For more information on how to use the **Ocp-Apim-Subscription-Region** header, _see_ [Text Translation REST API headers](translator-text-apis.md).
+    > * For more information on how to use the **Ocp-Apim-Subscription-Region** header, _see_ [Text Translation REST API headers](translator-text-apis.md#headers).
 
 <!-- checked -->
 <!--

articles/ai-services/translator/quickstart-text-sdk.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: quickstart
-ms.date: 07/18/2023
+ms.date: 09/06/2023
 ms.author: lajanuar
 ms.devlang: csharp, java, javascript, python
 ms.custom: mode-other, devx-track-dotnet, devx-track-extended-java, devx-track-js, devx-track-python
@@ -33,7 +33,7 @@ In this quickstart, get started using the Translator service to [translate text]
 
 You need an active Azure subscription. If you don't have an Azure subscription, you can [create one for free](https://azure.microsoft.com/free/cognitive-services/)
 
-* Once you have your Azure subscription, create a [Translator resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) in the Azure portal.
+* Once you have your Azure subscription, create a [Translator resource](create-translator-resource.md) in the [Azure portal](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation).
 
 * After your resource deploys, select **Go to resource** and retrieve your key and endpoint.