Skip to content

Commit 4b390b7

Browse files
Court72Court72
authored
Merge pull request #189192 from laujan/1915439-sovereign-cloud-update
Translator text sovereign cloud guide
2 parents aa540ac + 902735f commit 4b390b7

File tree

2 files changed

+188
-0
lines changed

2 files changed

+188
-0
lines changed

‎articles/cognitive-services/Translator/sovereign-clouds.md

Lines changed: 185 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
1+
---
2+
title: "Translator: sovereign clouds"
3+
titleSuffix: Azure Cognitive Services
4+
description: Using Translator in sovereign clouds
5+
services: cognitive-services
6+
author: laujan
7+
manager: nitinme
8+
ms.service: cognitive-services
9+
ms.subservice: translator-text
10+
ms.topic: reference
11+
ms.date: 02/24/2022
12+
ms.author: lajanuar
13+
---
14+
15+
# Translator in sovereign (national) clouds
16+
17+
Azure sovereign clouds are isolated in-country platforms with independent authentication, storage, and compliance requirements. Sovereign clouds are often used within geographical boundaries where there's a strict data residency requirement. Translator is currently deployed in the following sovereign clouds:
18+
19+
|Cloud | Region identifier |
20+
|---|--|
21+
| [Azure US Government](../../azure-government/documentation-government-welcome.md)|<ul><li>`usgovarizona` (US Gov Arizona)</li><li>`usgovvirginia` (US Gov Virginia)</li></ul>|
22+
| [Azure China 21 Vianet](/azure/china/overview-operations) |<ul><li>`chinaeast2` (East China 2)</li><li>`chinanorth` (China North)</li></ul>|
23+
24+
## Azure portal endpoints
25+
26+
The following table lists the base URLs for Azure sovereign cloud endpoints:
27+
28+
| Sovereign cloud | Azure portal endpoint |
29+
| --------------------------------------- | -------------------------- |
30+
| Azure portal for US Government | `https://portal.azure.us` |
31+
| Azure portal China operated by 21 Vianet | `https://portal.azure.cn` |
32+
33+
## Translator: sovereign clouds
34+
35+
### [Azure US Government](#tab/us)
36+
37+
The Azure Government cloud is available to US government customers and their partners. US federal, state, local, tribal governments and their partners have access to the Azure Government cloud dedicated instance. Cloud operations are controlled by screened US citizens.
38+
39+
| Azure US Government | Availability and support |
40+
|--|--|
41+
|Azure portal | <ul><li>[Azure Government Portal](https://portal.azure.us/)</li></ul>|
42+
| Available regions</br></br>The region-identifier is a required header when using Translator for the government cloud. | <ul><li>`usgovarizona` </li><li> `usgovvirginia`</li></ul>|
43+
|Available pricing tiers|<ul><li>Free (F0) and Standard (S0). See [Translator pricing](https://azure.microsoft.com/pricing/details/cognitive-services/translator/)</li></ul>|
44+
|Supported Features | <ul><li>Text Translation</li><li>Document Translation</li><li>Custom Translation</li></ul>|
45+
|Supported Languages| <ul><li>[Translator language support](language-support.md)</li></ul>|
46+
47+
<!-- markdownlint-disable MD036 -->
48+
49+
### Endpoint
50+
51+
#### Azure portal
52+
53+
Base URL:
54+
55+
```http
56+
https://portal.azure.us
57+
```
58+
59+
#### Authorization token
60+
61+
Replace the `<region-identifier>` parameter with the sovereign cloud identifier:
62+
63+
|Cloud | Region identifier |
64+
|---|--|
65+
| Azure US Government|<ul><li>`usgovarizona` (US Gov Arizona)</li><li>`usgovvirginia` (US Gov Virginia)</li></ul>|
66+
| Azure China 21 Vianet|<ul><li>`chinaeast2` (East China 2)</li><li>`chinanorth` (China North)</li></ul>|
67+
68+
```http
69+
https://<region-identifier>.api.cognitive.microsoft.us/sts/v1.0/issueToken
70+
```
71+
72+
#### Text translation
73+
74+
```http
75+
https://api.cognitive.microsofttranslator.us/
76+
```
77+
78+
#### Document Translation custom endpoint
79+
80+
Replace the `<your-custom-domain>` parameter with your [custom domain endpoint](document-translation/get-started-with-document-translation.md#what-is-the-custom-domain-endpoint).
81+
82+
```http
83+
https://<your-custom-domain>.cognitiveservices.azure.us/
84+
```
85+
86+
#### Custom Translator portal
87+
88+
```http
89+
https://portal.customtranslator.azure.us/
90+
```
91+
92+
### Example API translation request
93+
94+
Translate a single sentence from English to Simplified Chinese.
95+
96+
**Request**
97+
98+
```curl
99+
curl -X POST "https://api.cognitive.microsofttranslator.us/translate?api-version=3.0?&from=en&to=zh-Hans" -H "Ocp-Apim-Subscription-Key: <subscription key>" -H "Ocp-Apim-Subscription-Region: chinanorth" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'你好, 你叫什么名字？'}]"
100+
```
101+
102+
**Response body**
103+
104+
```JSON
105+
[
106+
{
107+
"translations":[
108+
{"text": "Hello, what is your name?", "to": "en"}
109+
]
110+
}
111+
]
112+
```
113+
114+
> [!div class="nextstepaction"]
115+
> [Azure Government: Translator text reference](reference/rest-api-guide.md)
116+
117+
### [Azure China 21 Vianet](#tab/china)
118+
119+
The Azure China cloud is a physical and logical network-isolated instance of cloud services located in China. In order to apply for an Azure China account, you need a Chinese legal entity, Internet Content provider (ICP) license, and physical presence within China.
120+
121+
|Azure China 21 Vianet | Availability and support |
122+
|---|---|
123+
|Azure portal |<ul><li>[Azure China 21 Vianet Portal](https://portal.azure.cn/)</li></ul>|
124+
|Regions <br></br>The region-identifier is a required header when using a multi-service resource. | <ul><li>`chinanorth` </li><li> `chinaeast2`</li></ul>|
125+
|Supported Feature|<ul><li>[Text Translation](https://docs.azure.cn/cognitive-services/translator/reference/v3-0-reference)</li></ul>|
126+
|Supported Languages|<ul><li>[Translator language support.](https://docs.azure.cn/cognitive-services/translator/language-support)</li></ul>|
127+
128+
<!-- markdownlint-disable MD036 -->
129+
<!-- markdownlint-disable MD024 -->
130+
131+
### Endpoint
132+
133+
Base URL
134+
135+
#### Azure portal
136+
137+
```http
138+
https://portal.azure.cn
139+
```
140+
141+
#### Authorization token
142+
143+
Replace the `<region-identifier>` parameter with the sovereign cloud identifier:
144+
145+
```http
146+
https://<region-identifier>.api.cognitive.azure.cn/sts/v1.0/issueToken
147+
```
148+
149+
#### Text translation
150+
151+
```http
152+
https://api.translator.azure.cn/translate
153+
```
154+
155+
### Example API translation request
156+
157+
Translate a single sentence from English to Simplified Chinese.
158+
159+
**Request**
160+
161+
```curl
162+
curl -X POST "https://api.translator.azure.cn/translate?api-version=3.0&from=en&to=zh-Hans" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text': 'Hello, what is your name?'}]"
163+
```
164+
165+
**Response body**
166+
167+
```JSON
168+
[
169+
{
170+
"translations":[
171+
{"text": "你好, 你叫什么名字？", "to": "zh-Hans"}
172+
]
173+
}
174+
]
175+
```
176+
177+
> [!div class="nextstepaction"]
178+
> [Azure China: Translator Text reference](https://docs.azure.cn/cognitive-services/translator/reference/v3-0-reference)
179+
180+
---
181+
182+
## Next step
183+
184+
> [!div class="nextstepaction"]
185+
> [Learn more about Translator](index.yml)

‎articles/cognitive-services/Translator/toc.yml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -220,6 +220,9 @@ items:
220220
href: custom-translator/faq.md
221221
- name: Resources
222222
items:
223+
- name: Sovereign Clouds
224+
displayName: fairfax,mooncake,compliant,secret,compliance,government,government cloud,dod,china
225+
href: sovereign-clouds.md
223226
- name: Compliance and certification
224227
href: https://www.microsoft.com/translator/business/notrace/
225228
- name: Code samples on GitHub

0 commit comments

Comments
 (0)