Skip to content

Commit cc327e9

Browse files
committed
update firewall settings
1 parent b3245cd commit cc327e9

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

articles/cognitive-services/Translator/reference/v3-0-reference.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ manager: nitinme
88
ms.service: cognitive-services
99
ms.subservice: translator-text
1010
ms.topic: reference
11-
ms.date: 12/06/2021
11+
ms.date: 04/20/2023
1212
ms.author: lajanuar
1313
---
1414

@@ -28,16 +28,16 @@ Version 3 of the Translator provides a modern JSON-based Web API. It improves us
2828

2929
Requests to Translator are, in most cases, handled by the datacenter that is closest to where the request originated. If there's a datacenter failure when using the global endpoint, the request may be routed outside of the geography.
3030

31-
To force the request to be handled within a specific geography, use the desired geographical endpoint. All requests are processed among the datacenters within the geography.
31+
To force the request to be handled within a specific geography, use the desired geographical endpoint. All requests are processed among the datacenters within the geography.
3232

3333
|Geography|Base URL (geographical endpoint)|Datacenters|
3434
|:--|:--|:--|
35-
|Global (non-regional)| api.cognitive.microsofttranslator.com|Closest available datacenter|
35+
|Global (`non-regional`)| api.cognitive.microsofttranslator.com|Closest available datacenter|
3636
|Asia Pacific| api-apc.cognitive.microsofttranslator.com|Korea South, Japan East, Southeast Asia, and Australia East|
3737
|Europe| api-eur.cognitive.microsofttranslator.com|North Europe, West Europe|
3838
|United States| api-nam.cognitive.microsofttranslator.com|East US, South Central US, West Central US, and West US 2|
3939

40-
<sup>1</sup> Customers with a resource located in Switzerland North or Switzerland West can ensure that their Text API requests are served within Switzerland. To ensure that requests are handled in Switzerland, create the Translator resource in the 'Resource region' 'Switzerland North' or 'Switzerland West', then use the resource's custom endpoint in your API requests. For example: If you create a Translator resource in Azure portal with 'Resource region' as 'Switzerland North' and your resource name is 'my-swiss-n', then your custom endpoint is "https://my-swiss-n.cognitiveservices.azure.com". And a sample request to translate is:
40+
<sup>`1`</sup> Customers with a resource located in Switzerland North or Switzerland West can ensure that their Text API requests are served within Switzerland. To ensure that requests are handled in Switzerland, create the Translator resource in the 'Resource region' 'Switzerland North' or 'Switzerland West', then use the resource's custom endpoint in your API requests. For example: If you create a Translator resource in Azure portal with 'Resource region' as 'Switzerland North' and your resource name is 'my-swiss-n', then your custom endpoint is "https://my-swiss-n.cognitiveservices.azure.com". And a sample request to translate is:
4141
```curl
4242
// Pass secret key and region using headers to a custom endpoint
4343
curl -X POST "https://my-swiss-n.cognitiveservices.azure.com/translator/text/v3.0/translate?to=fr" \
@@ -46,7 +46,7 @@ curl -X POST "https://my-swiss-n.cognitiveservices.azure.com/translator/text/v3.
4646
-H "Content-Type: application/json" \
4747
-d "[{'Text':'Hello'}]" -v
4848
```
49-
<sup>2</sup> Custom Translator isn't currently available in Switzerland.
49+
<sup>`2`</sup> Custom Translator isn't currently available in Switzerland.
5050

5151
## Authentication
5252

@@ -171,7 +171,7 @@ An authentication token is valid for 10 minutes. The token should be reused when
171171
|:-----|:----|
172172
|Authorization| The value is an access **bearer token** generated by Azure AD.</br><ul><li> The bearer token provides proof of authentication and validates the client's authorization to use the resource.</li><li> An authentication token is valid for 10 minutes and should be reused when making multiple calls to Translator.</br></li>*See* [Sample request: 2. Get a token](../../authentication.md?tabs=powershell#sample-request)</ul>|
173173
|Ocp-Apim-Subscription-Region| The value is the region of the **translator resource**.</br><ul><li> This value is optional if the resource is global.</li></ul>|
174-
|Ocp-Apim-ResourceId| The value is the Resource ID for your Translator resource instance.</br><ul><li>You'll find the Resource ID in the Azure portal at **Translator Resource → Properties**. </li><li>Resource ID format: </br>/subscriptions/<**subscriptionId**>/resourceGroups/<**resourceGroupName**>/providers/Microsoft.CognitiveServices/accounts/<**resourceName**>/</li></ul>|
174+
|Ocp-Apim-ResourceId| The value is the Resource ID for your Translator resource instance.</br><ul><li>You find the Resource ID in the Azure portal at **Translator Resource → Properties**. </li><li>Resource ID format: </br>/subscriptions/<**subscriptionId**>/resourceGroups/<**resourceGroupName**>/providers/Microsoft.CognitiveServices/accounts/<**resourceName**>/</li></ul>|
175175

176176
##### **Translator property page—Azure portal**
177177

0 commit comments

Comments
 (0)