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	usgovarizona (US Gov Arizona) usgovvirginia (US Gov Virginia)
Microsoft Azure operated by 21Vianet	chinaeast2 (East China 2) chinanorth (China North)

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

Azure US Government

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	Azure Government Portal
Available regions The region-identifier is a required header when using Translator for the government cloud.	usgovarizona usgovvirginia
Available pricing tiers	Free (F0) and Standard (S1). See Translator pricing
Supported Features	Text Translation Document Translation Custom Translator
Supported Languages	Translator language support

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	usgovarizona (US Gov Arizona) usgovvirginia (US Gov Virginia)
Azure operated by 21Vianet	chinaeast2 (East China 2) chinanorth (China North)

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"}
        ]
    }
]

Azure Government: Translator text reference

Azure operated by 21Vianet

The Azure operated by 21Vianet cloud is a physical and logical network-isolated instance of cloud services located in China. In order to apply for an Azure operated by 21Vianet account, you need a Chinese legal entity, Internet Content provider (ICP) license, and physical presence within China.

Azure operated by 21Vianet	Availability and support
Azure portal	Azure operated by 21Vianet Portal
Regions The region-identifier is a required header when using a multi-service resource.	chinanorth chinaeast2
Supported Feature	Text Translation Document Translation
Supported Languages	Translator language support.

Endpoint

Base URL

Azure portal

https://portal.azure.cn

Authorization token

Replace the <region-identifier> parameter with the sovereign cloud identifier:

https://<region-identifier>.api.cognitive.azure.cn/sts/v1.0/issueToken

Text translation

https://api.translator.azure.cn/translate

Example text translation request

Translate a single sentence from English to Simplified Chinese.

Request

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?'}]"

Response body

[
    {
        "translations":[
            {"text": "你好, 你叫什么名字？", "to": "zh-Hans"}
        ]
    }
]

Document Translation custom endpoint

https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.cn/translator/text/batch/v1.0

Example batch translation request

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://<storage_acount>.blob.core.chinacloudapi.cn/source-en?sv=2019-12-12&st=2021-03-05T17%3A45%3A25Z&se=2021-03-13T17%3A45%3A00Z&sr=c&sp=rl&sig=SDRPMjE4nfrH3csmKLILkT%2Fv3e0Q6SWpssuuQl1NmfM%3D"
            },
            "targets": [
                {
                    "targetUrl": "https://<storage_acount>.blob.core.chinacloudapi.cn/target-zh-Hans?sv=2019-12-12&st=2021-03-05T17%3A49%3A02Z&se=2021-03-13T17%3A49%3A00Z&sr=c&sp=wdl&sig=Sq%2BYdNbhgbq4hLT0o1UUOsTnQJFU590sWYo4BOhhQhs%3D",
                    "language": "zh-Hans"
                }
            ]
        }
    ]
}

Next steps

Learn more about Translator