Nomes de subdomínio personalizados para serviços cognitivasCustom subdomain names for Cognitive Services

Os serviços cognitivas do Azure usam nomes de subdomínio personalizados para cada recurso criado por meio do portal do Azure, Azure cloud Shellou CLI do Azure.Azure Cognitive Services use custom subdomain names for each resource created through the Azure portal, Azure Cloud Shell, or Azure CLI. Ao contrário dos pontos de extremidade regionais, que eram comuns para todos os clientes em uma região específica do Azure, os nomes de subdomínio personalizados são exclusivos para o recurso.Unlike regional endpoints, which were common for all customers in a specific Azure region, custom subdomain names are unique to the resource. Os nomes de subdomínio personalizados são necessários para habilitar recursos como o Azure Active Directory (Azure AD) para autenticação.Custom subdomain names are required to enable features like Azure Active Directory (Azure AD) for authentication.

Como isso afeta os recursos existentes?How does this impact existing resources?

Os recursos de serviços cognitivas criados antes de 1º de julho de 2019 usarão os pontos de extremidade regionais para o serviço associado.Cognitive Services resources created before July 1, 2019 will use the regional endpoints for the associated service. Esses pontos de extremidade funcionarão com recursos novos e existentes.These endpoints will work with existing and new resources.

Se você quiser migrar um recurso existente para aproveitar os nomes de subdomínio personalizados, para que possa habilitar recursos como o Azure AD, siga estas instruções:If you'd like to migrate an existing resource to leverage custom subdomain names, so that you can enable features like Azure AD, follow these instructions:

  1. Entre no portal do Azure e localize o recurso serviços cognitivas ao qual você gostaria de adicionar um nome de subdomínio personalizado.Sign in to the Azure portal and locate the Cognitive Services resource that you'd like to add a custom subdomain name to.
  2. Na folha visão geral , localize e selecione gerar nome de domínio personalizado.In the Overview blade, locate and select Generate Custom Domain Name.
  3. Isso abre um painel com instruções para criar um subdomínio personalizado exclusivo para seu recurso.This opens a panel with instructions to create a unique custom subdomain for your resource.

    Aviso

    Depois de criar um nome de subdomínio personalizado, ele não pode ser alterado.After you've created a custom subdomain name it cannot be changed.

É necessário atualizar meus recursos existentes?Do I need to update my existing resources?

Não.No. O ponto de extremidade Regional continuará a funcionar para serviços cognitivas novos e existentes, e o nome de subdomínio personalizado é opcional.The regional endpoint will continue to work for new and existing Cognitive Services and the custom subdomain name is optional. Mesmo que um nome de subdomínio personalizado seja adicionado, o ponto de extremidade Regional continuará funcionando com o recurso.Even if a custom subdomain name is added the regional endpoint will continue to work with the resource.

E se um SDK solicitar a região de um recurso?What if an SDK asks me for the region for a resource?

Aviso

Os serviços de fala não dão suporte a subdomínios personalizados no momento.The Speech Services do not support custom subdomains at this time. Use os pontos de extremidade regionais ao usar os serviços de fala e SDKs associados.Please use the regional endpoints when using the Speech Services and associated SDKs.

Os pontos de extremidade regionais e os nomes de subdomínio personalizados têm suporte e podem ser usados de forma intercambiável.Regional endpoints and custom subdomain names are both supported and can be used interchangeably. No entanto, o ponto de extremidade completo é necessário.However, the full endpoint is required.

As informações de região estão disponíveis na folha de visão geral do recurso no portal do Azure.Region information is available in the Overview blade for your resource in the Azure portal. Para obter a lista completa de pontos de extremidade regionais, consulte há uma lista de pontos de extremidade regionais?For the full list of regional endpoints, see Is there a list of regional endpoints?

Os nomes de subdomínio personalizados são regionais?Are custom subdomain names regional?

Sim.Yes. O uso de um nome de subdomínio personalizado não altera nenhum dos aspectos regionais de seu recurso de serviços cognitivas.Using a custom subdomain name doesn't change any of the regional aspects of your Cognitive Services resource.

Quais são os requisitos para um nome de subdomínio personalizado?What are the requirements for a custom subdomain name?

Um nome de subdomínio personalizado é exclusivo para seu recurso.A custom subdomain name is unique to your resource. O nome só pode incluir caracteres alfanuméricos e o caractere de -; Ele deve ter entre 2 e 64 caracteres de comprimento e não pode terminar com um -.The name can only include alphanumeric characters and the - character; it must be between 2 and 64 characters in length and cannot end with a -.

Posso alterar um nome de domínio personalizado?Can I change a custom domain name?

Não.No. Depois que um nome de subdomínio personalizado é criado e associado a um recurso, ele não pode ser alterado.After a custom subdomain name is created and associated with a resource it cannot be changed.

Posso reutilizar um nome de domínio personalizado?Can I reuse a custom domain name?

Cada nome de subdomínio personalizado é exclusivo, portanto, para reutilizar um nome de subdomínio personalizado que você atribuiu a um recurso de serviços cognitivas, você precisará excluir o recurso existente.Each custom subdomain name is unique, so in order to reuse a custom subdomain name that you've assigned to a Cognitive Services resource, you'll need to delete the existing resource. Depois que o recurso tiver sido excluído, você poderá reutilizar o nome de subdomínio personalizado.After the resource has been deleted, you can reuse the custom subdomain name.

Há uma lista de pontos de extremidade regionais?Is there a list of regional endpoints?

Sim.Yes. Esta é uma lista de pontos de extremidade regionais que você pode usar com os recursos de serviços cognitivas do Azure.This is a list of regional endpoints that you can use with Azure Cognitive Services resources.

Observação

O API de Tradução de Texto e APIs de Pesquisa do Bing usar pontos de extremidade globais.The Translator Text API and Bing Search APIs use global endpoints.

Tipo de ponto de extremidadeEndpoint type RegiãoRegion Ponto de extremidadeEndpoint
PúblicoPublic Global (Tradução de Texto & Bing)Global (Translator Text & Bing) https://api.cognitive.microsoft.com
Leste da AustráliaAustralia East https://australiaeast.api.cognitive.microsoft.com
Sul do BrasilBrazil South https://brazilsouth.api.cognitive.microsoft.com
Canadá CentralCanada Central https://canadacentral.api.cognitive.microsoft.com
Centro dos EUACentral US https://centralus.api.cognitive.microsoft.com
Leste da ÁsiaEast Asia https://eastasia.api.cognitive.microsoft.com
Leste dos EUAEast US https://eastus.api.cognitive.microsoft.com
Leste dos EUA 2East US 2 https://eastus2.api.cognitive.microsoft.com
França CentralFrance Central https://francecentral.api.cognitive.microsoft.com
Centro da ÍndiaIndia Central https://centralindia.api.cognitive.microsoft.com
Leste do JapãoJapan East https://japaneast.api.cognitive.microsoft.com
Coreia CentralKorea Central https://koreacentral.api.cognitive.microsoft.com
Centro-Norte dos EUANorth Central US https://northcentralus.api.cognitive.microsoft.com
Europa do NorteNorth Europe https://northeurope.api.cognitive.microsoft.com
Norte da África do SulSouth Africa North https://southafricanorth.api.cognitive.microsoft.com
Centro-Sul dos Estados UnidosSouth Central US https://southcentralus.api.cognitive.microsoft.com
Sudeste AsiáticoSoutheast Asia https://southeastasia.api.cognitive.microsoft.com
Sul do Reino UnidoUK South https://uksouth.api.cognitive.microsoft.com
Centro-Oeste dos EUAWest Central US https://westcentralus.api.cognitive.microsoft.com
Europa OcidentalWest Europe https://westeurope.api.cognitive.microsoft.com
Oeste dos EUAWest US https://westus.api.cognitive.microsoft.com
Oeste dos EUA 2West US 2 https://westus2.api.cognitive.microsoft.com
Gov dos EUAUS Gov Gov. dos EUA – VirgíniaUS Gov Virginia https://virginia.api.cognitive.microsoft.us
ChinaChina Leste da China 2China East 2 https://chinaeast2.api.cognitive.azure.cn
Norte da ChinaChina North https://chinanorth.api.cognitive.azure.cn

Confira tambémSee also