Nomi di sottodominio personalizzati per i Servizi di Azure AI

Articolo
07/08/2024

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:

Accedere al portale di Azure e individuare la risorsa dei Servizi di Azure AI a cui si vuole aggiungere un nome di sottodominio personalizzato.
Nel pannello Panoramica individuare e selezionare Genera nome di dominio personalizzato.
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`

Condividi tramite