Translator in sovereign (national) clouds
Azure sovereign clouds are isolated in-country/region 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:
Cloud | Region identifier |
---|---|
Azure US Government |
|
Microsoft Azure operated by 21Vianet |
|
Azure portal endpoints
The following table lists the base URLs for Azure sovereign cloud endpoints:
Sovereign cloud | Azure portal endpoint |
---|---|
Azure portal for US Government | https://portal.azure.us |
Azure portal China operated by 21 Vianet | https://portal.azure.cn |
Translator: sovereign clouds
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. Screened US citizens control cloud operations.
Azure US Government | Availability and support |
---|---|
Azure portal | |
Available regions The region-identifier is a required header when using Translator for the government cloud. |
|
Available pricing tiers |
|
Supported Features | |
Supported Languages |
Endpoint
Azure portal
Base URL:
https://portal.azure.us
Authorization token
Replace the <region-identifier>
parameter with the sovereign cloud identifier:
Cloud | Region identifier |
---|---|
Azure US Government |
|
Azure operated by 21Vianet |
|
https://<region-identifier>.api.cognitive.microsoft.us/sts/v1.0/issueToken
Text translation
https://api.cognitive.microsofttranslator.us/
Document Translation custom endpoint
https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.us/translator/text/batch/v1.0
Custom Translator portal
https://portal.customtranslator.azure.us/
Example API translation request
Translate a single sentence from English to Simplified Chinese.
Request
curl -X POST "https://api.cognitive.microsofttranslator.us/translate?api-version=3.0?&from=en&to=zh-Hans" -H "Ocp-Apim-Subscription-Key: <key>" -H "Ocp-Apim-Subscription-Region: chinanorth" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'你好, 你叫什么名字?'}]"
Response body
[
{
"translations":[
{"text": "Hello, what is your name?", "to": "en"}
]
}
]