Nombres de subdominios personalizados para Cognitive Services

Azure Cognitive Services usa nombres de subdominio personalizados para cada recurso creado a través de Azure Portal, Azure Cloud Shell o la CLI de Azure. A diferencia de los puntos de conexión regionales, que son comunes para todos los clientes de una región específica de Azure, los nombres de subdominio personalizados son únicos en el recurso. Los nombres de subdominio personalizados son necesarios para habilitar características como Azure Active Directory (Azure AD) para la autenticación.

¿Cómo afecta esto a los recursos existentes?

Los recursos de Cognitive Services creados antes del 1 de julio de 2019 usarán los puntos de conexión regionales del servicio asociado. Estos puntos de conexión funcionarán con recursos nuevos y existentes.

Si quiere migrar un recurso existente para aprovechar los nombres de subdominio personalizado, de modo que pueda habilitar características como Azure AD, siga estas instrucciones:

  1. Inicie sesión en Azure Portal y busque el recurso de Cognitive Services al que le gustaría agregar un nombre de subdominio personalizado.
  2. En la hoja de información general, busque y seleccione la opción para generar un nombre de dominio personalizado.
  3. Se abrirá un panel con instrucciones para crear un subdominio personalizado único para el recurso.

    Advertencia

    Después de crear un nombre de subdominio personalizado, no se puede cambiar.

¿Es necesario actualizar mis recursos existentes?

No. El punto de conexión regional continuará funcionando para las instancias de Cognitive Services nuevas y existentes; asimismo, el nombre de subdominio personalizado es opcional. Incluso si se agrega un nombre de subdominio personalizado, el punto de conexión regional continuará funcionando con el recurso.

¿Qué ocurre si un SDK me pide la región de un recurso?

Advertencia

Los servicios de voz usan subdominios personalizados únicamente con puntos de conexión privados. En el resto de casos, use los puntos de conexión regionales con los servicios de voz y los SDK asociados.

Los puntos de conexión regionales y los nombres de subdominio personalizados se admiten y se pueden usar indistintamente. Sin embargo, se requiere el punto de conexión completo.

La información de la región está disponible en la hoja de información general del recurso de Azure Portal. Para obtener una lista completa de los puntos de conexión regionales, consulte ¿Hay alguna lista de puntos de conexión regionales?

¿Son regionales los nombres de subdominios personalizados?

Sí. El uso de un nombre de subdominio personalizado no cambia ninguno de los aspectos regionales del recurso de Cognitive Services.

¿Cuáles son los requisitos para un nombre de subdominio personalizado?

Un nombre de subdominio personalizado es único para el recurso. El nombre solo puede incluir caracteres alfanuméricos y el carácter -; además, debe tener entre 2 y 64 caracteres de longitud y no puede terminar con -.

¿Se puede cambiar un nombre de dominio personalizado?

No. Una vez que se crea un nombre de subdominio personalizado y se asocia a un recurso, no se puede cambiar.

¿Puedo reutilizar un nombre de dominio personalizado?

Cada nombre de subdominio personalizado es único, por lo que para reutilizar un nombre de subdominio personalizado que haya sido asignado a un recurso de Cognitive Services, deberá eliminar el recurso existente. Una vez eliminado el recurso, puede volver a usar el nombre de subdominio personalizado.

¿Hay una lista de puntos de conexión regionales?

Sí. Esta es una lista de puntos de conexión regionales que puede usar con los recursos de Cognitive Services de Azure.

Nota

Las API del servicio Traductor y de Bing Search usan puntos de conexión globales.

Tipo de punto de conexión Region Punto de conexión
Público Global (Traductor y Bing) https://api.cognitive.microsoft.com
Este de Australia https://australiaeast.api.cognitive.microsoft.com
Sur de Brasil https://brazilsouth.api.cognitive.microsoft.com
Centro de Canadá https://canadacentral.api.cognitive.microsoft.com
Centro de EE. UU. https://centralus.api.cognitive.microsoft.com
Este de Asia https://eastasia.api.cognitive.microsoft.com
Este de EE. UU. https://eastus.api.cognitive.microsoft.com
Este de EE. UU. 2 https://eastus2.api.cognitive.microsoft.com
Centro de Francia https://francecentral.api.cognitive.microsoft.com
India central https://centralindia.api.cognitive.microsoft.com
Japón Oriental https://japaneast.api.cognitive.microsoft.com
Centro de Corea del Sur https://koreacentral.api.cognitive.microsoft.com
Centro-Norte de EE. UU https://northcentralus.api.cognitive.microsoft.com
Norte de Europa https://northeurope.api.cognitive.microsoft.com
Norte de Sudáfrica https://southafricanorth.api.cognitive.microsoft.com
Centro-sur de EE. UU. https://southcentralus.api.cognitive.microsoft.com
Sudeste de Asia https://southeastasia.api.cognitive.microsoft.com
Sur de Reino Unido https://uksouth.api.cognitive.microsoft.com
Centro-Oeste de EE. UU. https://westcentralus.api.cognitive.microsoft.com
Oeste de Europa https://westeurope.api.cognitive.microsoft.com
Oeste de EE. UU. https://westus.api.cognitive.microsoft.com
Oeste de EE. UU. 2 https://westus2.api.cognitive.microsoft.com
US Gov US Gov - Virginia https://virginia.api.cognitive.microsoft.us
China Este de China 2 https://chinaeast2.api.cognitive.azure.cn
Norte de China https://chinanorth.api.cognitive.azure.cn

Consulte también