Nomi di sottodominio personalizzati per i Servizi di Azure AI

A partire dal mese di luglio 2019, i Servizi di Azure AI usano nomi di sottodominio personalizzati per ogni risorsa creata tramite il portale di Azure, Azure Cloud Shell o l'interfaccia della riga di comando di Azure. A differenza degli endpoint a livello di area, comuni a tutti i clienti in una specifica area di Azure, i nomi di sottodominio personalizzati sono univoci per la risorsa. Per abilitare funzionalità come Microsoft Entra ID per l'autenticazione, sono necessari nomi di sottodomini personalizzati.

In che modo questo influisce sulle risorse esistenti?

Le risorse dei Servizi di Azure AI create prima del 1° luglio 2019 usano gli endpoint a livello di area per il servizio associato. Questi endpoint funzionano con le risorse nuove ed esistenti.

Se si vuole eseguire la migrazione di una risorsa esistente per usare nomi di sottodomini personalizzati per abilitare funzionalità come Microsoft Entra ID, seguire queste istruzioni:

  1. Accedere al portale di Azure e individuare la risorsa dei Servizi di Azure AI a cui si vuole aggiungere un nome di sottodominio personalizzato.
  2. Nel pannello Panoramica individuare e selezionare Genera nome di dominio personalizzato.
  3. Verrà aperto un pannello con le istruzioni per creare un sottodominio personalizzato univoco per la risorsa.

    Avviso

    Dopo aver creato un nome di sottodominio personalizzato, non è possibile modificarlo.

È necessario aggiornare le risorse esistenti?

No. L'endpoint a livello di area continuerà a funzionare per i Servizi di Azure AI nuovi ed esistenti e il nome di sottodominio personalizzato è facoltativo. Anche se si aggiunge un nome di sottodominio personalizzato, l'endpoint a livello di area continuerà a funzionare con la risorsa.

Cosa accade se un'SDK chiede di inserire l'area per una risorsa?

Avviso

I servizi Voce usano i sottodomini personalizzati solo con gli endpoint privati. In tutti gli altri casi, usare endpoint a livello di area con i servizi Voce e gli SDK associati.

Gli endpoint a livello di area e i nomi di sottodominio personalizzati sono entrambi supportati e possono essere usati in modo intercambiabile. Tuttavia, è necessario l'endpoint completo.

Le informazioni relative all'area sono disponibili nel pannello Panoramica relativo alla risorsa nel portale di Azure. Per l'elenco completo degli endpoint a livello di area, vedere È disponibile un elenco di endpoint a livello di area?

I nomi di sottodominio personalizzati sono a livello di area?

Sì. L'uso di un nome di sottodominio personalizzato non modifica gli aspetti a livello di area della risorsa dei Servizi di Azure AI.

Quali sono i requisiti per un nome di sottodominio personalizzato?

Un nome di sottodominio personalizzato è univoco per la risorsa. Il nome può includere solo caratteri alfanumerici e il carattere -, deve avere una lunghezza compresa tra 2 e 64 caratteri e non può terminare con -.

È possibile modificare un nome di dominio personalizzato?

No. Dopo aver creato un nome di sottodominio personalizzato e averlo associato a una risorsa, non è possibile modificarlo.

È possibile riutilizzare un nome di dominio personalizzato?

Ogni nome di sottodominio personalizzato è univoco, quindi per riutilizzare un nome di sottodominio personalizzato assegnato a una risorsa dei Servizi di Azure AI è necessario eliminare la risorsa esistente. Dopo l'eliminazione della risorsa, sarà possibile riutilizzare il nome di sottodominio personalizzato.

È disponibile un elenco di endpoint a livello di area?

Sì. Questo è un elenco di endpoint a livello di area che è possibile usare con le risorse dei Servizi di Azure AI.

Nota

Il servizio Traduttore e le API di Ricerca Bing usano endpoint globali.

Tipo di endpoint Area Endpoint
Pubblico Globale (Traduttore e Bing) https://api.cognitive.microsoft.com
Australia orientale https://australiaeast.api.cognitive.microsoft.com
Brasile meridionale https://brazilsouth.api.cognitive.microsoft.com
Canada centrale https://canadacentral.api.cognitive.microsoft.com
Stati Uniti centrali https://centralus.api.cognitive.microsoft.com
Asia orientale https://eastasia.api.cognitive.microsoft.com
Stati Uniti orientali https://eastus.api.cognitive.microsoft.com
Stati Uniti orientali 2 https://eastus2.api.cognitive.microsoft.com
Francia centrale https://francecentral.api.cognitive.microsoft.com
India centrale https://centralindia.api.cognitive.microsoft.com
Giappone orientale https://japaneast.api.cognitive.microsoft.com
Corea centrale https://koreacentral.api.cognitive.microsoft.com
Stati Uniti centro-settentrionali https://northcentralus.api.cognitive.microsoft.com
Europa settentrionale https://northeurope.api.cognitive.microsoft.com
Sudafrica settentrionale https://southafricanorth.api.cognitive.microsoft.com
Stati Uniti centro-meridionali https://southcentralus.api.cognitive.microsoft.com
Asia sud-orientale https://southeastasia.api.cognitive.microsoft.com
Regno Unito meridionale https://uksouth.api.cognitive.microsoft.com
Stati Uniti centro-occidentali https://westcentralus.api.cognitive.microsoft.com
Europa occidentale https://westeurope.api.cognitive.microsoft.com
Stati Uniti occidentali https://westus.api.cognitive.microsoft.com
West US 2 https://westus2.api.cognitive.microsoft.com
US Gov US Gov Virginia https://virginia.api.cognitive.microsoft.us
Cina Cina orientale 2 https://chinaeast2.api.cognitive.azure.cn
Cina settentrionale https://chinanorth.api.cognitive.azure.cn

Vedi anche