Merge pull request #231794 from laujan/72694-update-qs-screenshot-storage-container

update screenshot and container

Author: JamesJBarnett

articles/cognitive-services/Translator/create-translator-resource.md

@@ -70,11 +70,12 @@ All Cognitive Services API requests require an endpoint URL and a read-only key
 1. In the left rail, under *Resource Management*, select **Keys and Endpoint**.
 1. Copy and paste your keys and endpoint URL in a convenient location, such as *Microsoft Notepad*.
 
-:::image type="content" source="../media/cognitive-services-apis-create-account/get-cog-serv-keys.png" alt-text="Get key and endpoint.":::
+:::image type="content" source="media/keys-and-endpoint-resource.png" alt-text="Get key and endpoint.":::
 
 ## How to delete a  resource or resource group
 
-> [!Warning]
+> [!WARNING]
+>
 > Deleting a resource group also deletes all resources contained in the group.
 
 To remove a Cognitive Services or Translator resource, you can **delete the resource** or **delete the resource group**.

articles/cognitive-services/Translator/document-translation/how-to-guides/use-client-sdks.md

@@ -15,11 +15,11 @@ ms.author: lajanuar
 # Document Translation client-library SDKs
 <!-- markdownlint-disable MD024 -->
 <!-- markdownlint-disable MD001 -->
-[Document Translation](../overview.md) is a cloud-based feature of the [Azure Translator](../../translator-overview.md) service. You can translate entire documents or process batch document translations in various file formats while preserving original document structure and format. In this article, you'll learn how to use the Document Translation service C#/.NET and Python client libraries. For the REST API, see our [Quickstart](../quickstarts/get-started-with-rest-api.md) guide.
+[Document Translation](../overview.md) is a cloud-based feature of the [Azure Translator](../../translator-overview.md) service. You can translate entire documents or process batch document translations in various file formats while preserving original document structure and format. In this article, you learn how to use the Document Translation service C#/.NET and Python client libraries. For the REST API, see our [Quickstart](../quickstarts/get-started-with-rest-api.md) guide.
 
 ## Prerequisites
 
-To get started, you'll need:
+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/).
 
@@ -28,7 +28,7 @@ To get started, you'll need:
 * 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:
 
   * **Source container**. This container is where you upload your files for translation (required).
-  * **Target container**. This container is where your translated files will be stored (required).
+  * **Target container**. This container is where your translated files are stored (required).
 
 * You also 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. *See* [**Create SAS tokens for Document Translation process**](create-sas-tokens.md).
 
@@ -103,7 +103,7 @@ using System;
 using System.Threading;
 ```
 
-In the application's **Program** class, create variables for your key and custom endpoint. For details, *see* [Custom domain name and key](../quickstarts/get-started-with-rest-api.md#your-custom-domain-name-and-key)
+In the application's **Program** class, create variables for your key and custom endpoint. For more information, *see* [Retrieve your key and custom domain endpoint](../quickstarts/get-started-with-rest-api.md#retrieve-your-key-and-document-translation-endpoint).
 
 ```csharp
 private static readonly string endpoint = "<your custom endpoint>";
@@ -112,12 +112,12 @@ private static readonly string key = "<your key>";
 
 ### Translate a document or batch files
 
-* To Start a translation operation for one or more documents in a single blob container, you'll call the `StartTranslationAsync` method.
+* To Start a translation operation for one or more documents in a single blob container, you call the `StartTranslationAsync` method.
 
 * To call `StartTranslationAsync`, you need to initialize a `DocumentTranslationInput`  object that contains the following parameters:
 
 * **sourceUri**. The SAS URI for the source container containing documents to be translated.
-* **targetUri** The SAS URI for the target container to which the translated documents will be written.
+* **targetUri** The SAS URI for the target container to which the translated documents are written.
 * **targetLanguageCode**. The language code for the translated documents. You can find language codes on our [Language support](../../language-support.md) page.
 
 ```csharp
@@ -185,8 +185,7 @@ from azure.core.credentials import AzureKeyCredential
 from azure.ai.translation.document import DocumentTranslationClient
 ```
 
-Create variables for your resource key, custom endpoint, sourceUrl, and targetUrl. For
-more information, *see*  [Custom domain name and key](../quickstarts/get-started-with-rest-api.md#your-custom-domain-name-and-key)
+Create variables for your resource key, custom endpoint, sourceUrl, and targetUrl. For more information, *see* [Retrieve your key and custom domain endpoint](../quickstarts/get-started-with-rest-api.md#retrieve-your-key-and-document-translation-endpoint).
 
 ```python
 key = "<your-key>"

articles/cognitive-services/Translator/document-translation/how-to-guides/use-rest-api-programmatically.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: quickstart
-ms.date: 03/17/2023
+ms.date: 03/22/2023
 ms.author: lajanuar
 recommendations: false
 ms.devlang: csharp, golang, java, javascript, python
@@ -31,7 +31,10 @@ 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/).
 
-* An [**Azure blob storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). You create containers to store and organize your blob data within your storage account.
+* An [**Azure blob storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). You also need to [create containers](#create-azure-blob-storage-containers) 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).
 
 * A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Cognitive Services resource):
 
@@ -56,26 +59,19 @@ To get started, you need:
 
   1. After your resource has successfully deployed, select **Go to resource**.
 
-## Your custom domain name and key
-
-> [!IMPORTANT]
->
-> * **All API requests to the Document Translation service require a custom domain endpoint**.
-> * You won't use the endpoint found on your Azure portal resource _Keys and Endpoint_ page nor the global translator endpoint—`api.cognitive.microsofttranslator.com`—to make HTTP requests to Document Translation.
+### Retrieve your key and custom domain endpoint
 
-### What is the custom domain endpoint?
+*Requests to the Translator service require a read-only key and custom endpoint to authenticate access. The custom domain endpoint is a URL formatted with your resource name, hostname, and Translator subdirectories and is available in the Azure portal.
 
-The custom domain endpoint is a URL formatted with your resource name, hostname, and Translator subdirectories:
+1. If you've created a new resource, after it deploys, select **Go to resource**. If you have an existing Document Translation resource, navigate directly to your resource page.
 
-```http
-https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.0
-```
+1. In the left rail, under *Resource Management*, select **Keys and Endpoint**.
 
-### Find your custom domain name
+1. Copy and paste your **`key`** and **`document translation endpoint`** in a convenient location, such as *Microsoft Notepad*. Only one key is necessary to make an API call.
 
-The **NAME-OF-YOUR-RESOURCE** (also called *custom domain name*) parameter is the value that you entered in the **Name** field when you created your Translator resource.
+1. You **`key`** and **`document translation endpoint`** into the code samples to authenticate your request to the Document Translation service.
 
-:::image type="content" source="../../media/instance-details.png" alt-text="Image of the Azure portal, create resource, instant details, name field.":::
+    :::image type="content" source="../media/document-translation-key-endpoint.png" alt-text="Screenshot showing the get your key field in Azure portal.":::
 
 ### Get your key
 

articles/cognitive-services/Translator/document-translation/quickstarts/get-started-with-rest-api.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: quickstart
-ms.date: 03/17/2023
+ms.date: 03/22/2023
 ms.author: lajanuar
 recommendations: false
 ms.devlang: csharp, golang, java, javascript, python
@@ -32,7 +32,10 @@ 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/).
 
-* An [**Azure blob storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). You also need to create containers to store and organize your blob data within your storage account.
+* An [**Azure blob storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). You also need to [create containers](#create-azure-blob-storage-containers) 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).
 
 * A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Cognitive Services resource):
 
@@ -57,29 +60,20 @@ To get started, you need:
 
   1. After your resource has successfully deployed, select **Go to resource**.
 
-## Your custom domain name and key
-
-The custom domain endpoint is a URL formatted with your resource name, hostname, and Translator subdirectories and is available in the Azure portal.
-
-> [!IMPORTANT]
->
-> * **All API requests to the Document Translation service require a custom domain endpoint**.
-> * Don't use the Text Translation endpoint found on your Azure portal resource *Keys and Endpoint* page nor the global translator endpoint—`api.cognitive.microsofttranslator.com`—to make HTTP requests to Document Translation.
-
 > [!div class="nextstepaction"]
 > [I ran into an issue with the prerequisites.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?Pillar=Language&Product=Document-translation&Page=quickstart&Section=Prerequisites)
 
-### Retrieve your key and endpoint
+### Retrieve your key and document translation endpoint
 
-Requests to the Translator service require a read-only key and custom endpoint to authenticate access.
+*Requests to the Translator service require a read-only key and custom endpoint to authenticate access. The custom domain endpoint is a URL formatted with your resource name, hostname, and Translator subdirectories and is available in the Azure portal.
 
 1. If you've created a new resource, after it deploys, select **Go to resource**. If you have an existing Document Translation resource, navigate directly to your resource page.
 
 1. In the left rail, under *Resource Management*, select **Keys and Endpoint**.
 
 1. Copy and paste your **`key`** and **`document translation endpoint`** in a convenient location, such as *Microsoft Notepad*. Only one key is necessary to make an API call.
 
-1. You **`key`** and **`document translation endpoint`** into the code samples to authenticate your request to the Document Translation service.
+1. You paste your **`key`** and **`document translation endpoint`** into the code samples to authenticate your request to the Document Translation service.
 
     :::image type="content" source="../media/document-translation-key-endpoint.png" alt-text="Screenshot showing the get your key field in Azure portal.":::