You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/cognitive-services/Translator/document-translation/how-to-guides/use-rest-api-programmatically.md
* 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/).
33
33
34
-
* 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.
34
+
* 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:
35
+
36
+
***Source container**. This container is where you upload your files for translation (required).
37
+
***Target container**. This container is where your translated files will be stored (required).
35
38
36
39
* A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Cognitive Services resource):
37
40
@@ -56,26 +59,19 @@ To get started, you need:
56
59
57
60
1. After your resource has successfully deployed, select **Go to resource**.
58
61
59
-
## Your custom domain name and key
60
-
61
-
> [!IMPORTANT]
62
-
>
63
-
> ***All API requests to the Document Translation service require a custom domain endpoint**.
64
-
> * 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.
62
+
### Retrieve your key and custom domain endpoint
65
63
66
-
### What is the custom domain endpoint?
64
+
*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.
67
65
68
-
The custom domain endpoint is a URL formatted with your resource name, hostname, and Translator subdirectories:
66
+
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**.
73
69
74
-
### Find your custom domain name
70
+
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.
75
71
76
-
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.
72
+
1. You **`key`**and **`document translation endpoint`** into the code samples to authenticate your request to the Document Translation service.
77
73
78
-
:::image type="content" source="../../media/instance-details.png" alt-text="Image of the Azure portal, create resource, instant details, name field.":::
74
+
:::image type="content" source="../media/document-translation-key-endpoint.png" alt-text="Screenshot showing the get your key field in Azure portal.":::
* 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/).
34
34
35
-
* 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.
35
+
* 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:
36
+
37
+
***Source container**. This container is where you upload your files for translation (required).
38
+
***Target container**. This container is where your translated files will be stored (required).
36
39
37
40
* A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Cognitive Services resource):
38
41
@@ -57,21 +60,12 @@ To get started, you need:
57
60
58
61
1. After your resource has successfully deployed, select **Go to resource**.
59
62
60
-
## Your custom domain name and key
61
-
62
-
The custom domain endpoint is a URL formatted with your resource name, hostname, and Translator subdirectories and is available in the Azure portal.
63
-
64
-
> [!IMPORTANT]
65
-
>
66
-
> ***All API requests to the Document Translation service require a custom domain endpoint**.
67
-
> * 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.
68
-
69
63
> [!div class="nextstepaction"]
70
64
> [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)
71
65
72
-
### Retrieve your key and endpoint
66
+
### Retrieve your key and custom domain endpoint
73
67
74
-
Requests to the Translator service require a read-only key and custom endpoint to authenticate access.
68
+
*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.
75
69
76
70
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.
0 commit comments