Benutzerdefinierte Unterdomänennamen für Cognitive ServicesCustom subdomain names for Cognitive Services

Azure Cognitive Services verwenden benutzerdefinierte Unterdomänennamen für jede Ressource, die über das Azure-Portal, Azure Cloud Shell oder die Azure CLI erstellt wurde.Azure Cognitive Services use custom subdomain names for each resource created through the Azure portal, Azure Cloud Shell, or Azure CLI. Anders als bei regionalen Endpunkten, die für alle Kunden in einer bestimmten Azure-Region üblich waren, sind benutzerdefinierte Unterdomänennamen für die Ressource eindeutig.Unlike regional endpoints, which were common for all customers in a specific Azure region, custom subdomain names are unique to the resource. Benutzerdefinierte Unterdomänennamen sind erforderlich, um Funktionen wie Azure Active Directory (Azure AD) für die Authentifizierung zu aktivieren.Custom subdomain names are required to enable features like Azure Active Directory (Azure AD) for authentication.

Wie wirkt sich dies auf vorhandene Ressourcen aus?How does this impact existing resources?

Für Cognitive Services-Ressourcen, die vor dem 1. Juli 2019 erstellt wurden, werden die regionalen Endpunkte für den zugeordneten Dienst verwendet.Cognitive Services resources created before July 1, 2019 will use the regional endpoints for the associated service. Diese Endpunkte können mit den vorhandenen und neuen Ressourcen verwendet werden.These endpoints will work with existing and new resources.

Führen Sie zum Migrieren einer vorhandenen Ressource die folgenden Schritte aus, um benutzerdefinierte Unterdomänennamen zu verwenden, sodass Sie Funktionen wie Azure AD aktivieren können: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. Melden Sie sich beim Azure-Portal an, und suchen Sie die Cognitive Services-Ressource, der Sie einen benutzerdefinierten Unterdomänennamen hinzufügen möchten.Sign in to the Azure portal and locate the Cognitive Services resource that you'd like to add a custom subdomain name to.
  2. Suchen Sie auf dem Blatt Übersicht nach Generate Custom Domain Name (Benutzerdefinierten Domänennamen generieren), und klicken Sie darauf.In the Overview blade, locate and select Generate Custom Domain Name.
  3. Dadurch wird ein Panel mit Anweisungen zum Erstellen einer eindeutigen benutzerdefinierten Unterdomäne für Ihre Ressource geöffnet.This opens a panel with instructions to create a unique custom subdomain for your resource.

    Warnung

    Nachdem Sie einen benutzerdefinierten Unterdomänennamen erstellt haben, kann dieser nicht mehr geändert werden.After you've created a custom subdomain name it cannot be changed.

Muss ich meine vorhandenen Ressourcen aktualisieren?Do I need to update my existing resources?

Nein.No. Der regionale Endpunkt funktioniert weiterhin für neue und vorhandene Cognitive Services-Komponenten, und der benutzerdefinierte Unterdomänenname ist optional.The regional endpoint will continue to work for new and existing Cognitive Services and the custom subdomain name is optional. Auch wenn ein benutzerdefinierter Unterdomänenname hinzugefügt wird, funktioniert der regionale Endpunkt weiterhin mit der Ressource.Even if a custom subdomain name is added the regional endpoint will continue to work with the resource.

Was geschieht, wenn ein SDK die Region für eine Ressource anfordert?What if an SDK asks me for the region for a resource?

Warnung

Benutzerdefinierte Unterdomänen werden zurzeit nicht von Speech-Diensten unterstützt.The Speech Services do not support custom subdomains at this time. Verwenden Sie die regionalen Endpunkte bei Verwendung der Speech-Dienste und der zugeordneten SDKs.Please use the regional endpoints when using the Speech Services and associated SDKs.

Regionale Endpunkte und benutzerdefinierte Unterdomänennamen werden unterstützt und können austauschbar verwendet werden.Regional endpoints and custom subdomain names are both supported and can be used interchangeably. Dennoch ist der vollständige Endpunkt erforderlich.However, the full endpoint is required.

Informationen zu Regionen sind auf dem Blatt Übersicht für Ihre Ressource im Azure-Portal verfügbar.Region information is available in the Overview blade for your resource in the Azure portal. Eine vollständige Liste der regionalen Endpunkte finden Sie unter Gibt es eine Liste der regionalen Endpunkte?For the full list of regional endpoints, see Is there a list of regional endpoints?

Sind benutzerdefinierte Unterdomänennamen regional?Are custom subdomain names regional?

Ja.Yes. Wenn Sie einen benutzerdefinierten Unterdomänennamen verwenden, werden die regionalen Aspekte Ihrer Cognitive Services-Ressource nicht geändert.Using a custom subdomain name doesn't change any of the regional aspects of your Cognitive Services resource.

Welche Anforderungen gelten für einen benutzerdefinierten Unterdomänennamen?What are the requirements for a custom subdomain name?

Ein benutzerdefinierter Unterdomänenname ist für Ihre Ressource eindeutig.A custom subdomain name is unique to your resource. Der Name kann nur alphanumerische Zeichen und das Zeichen - enthalten. Er muss zwischen 2 und 64 Zeichen lang sein und darf nicht mit dem Zeichen - enden.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 -.

Kann ich einen benutzerdefinierten Domänennamen ändern?Can I change a custom domain name?

Nein.No. Nachdem Sie einen benutzerdefinierten Unterdomänennamen erstellt und einer Ressource zugeordnet haben, kann dieser nicht mehr geändert werden.After a custom subdomain name is created and associated with a resource it cannot be changed.

Kann ich einen benutzerdefinierten Domänennamen wieder verwenden?Can I reuse a custom domain name?

Jeder benutzerdefinierte Unterdomänenname ist eindeutig. Wenn Sie also einen einer Cognitive Services-Ressource zugeordneten benutzerdefinierten Unterdomänennamen wieder verwenden möchten, müssen Sie die vorhandene Ressource löschen.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. Nachdem die Ressource gelöscht wurde, können Sie den benutzerdefinierten Unterdomänennamen wieder verwenden.After the resource has been deleted, you can reuse the custom subdomain name.

Gibt es eine Liste regionaler Endpunkte?Is there a list of regional endpoints?

Ja.Yes. Dies ist eine Liste der regionalen Endpunkte, die Sie mit Azure Cognitive Services-Ressourcen verwenden können.This is a list of regional endpoints that you can use with Azure Cognitive Services resources.

Hinweis

Die Textübersetzungs-API und die Bing-Suche-APIs verwenden globale Endpunkte.The Translator Text API and Bing Search APIs use global endpoints.

EndpunkttypEndpoint type RegionRegion EndpunktEndpoint
ÖffentlichPublic Global (Textübersetzung und Bing)Global (Translator Text & Bing) https://api.cognitive.microsoft.com
Australien (Osten)Australia East https://australiaeast.api.cognitive.microsoft.com
Brasilien SüdBrazil South https://brazilsouth.api.cognitive.microsoft.com
Kanada, MitteCanada Central https://canadacentral.api.cognitive.microsoft.com
USA (Mitte)Central US https://centralus.api.cognitive.microsoft.com
Asien, OstenEast Asia https://eastasia.api.cognitive.microsoft.com
East USEast US https://eastus.api.cognitive.microsoft.com
USA (Ost) 2East US 2 https://eastus2.api.cognitive.microsoft.com
Frankreich, MitteFrance Central https://francecentral.api.cognitive.microsoft.com
Indien, MitteIndia Central https://centralindia.api.cognitive.microsoft.com
Japan, OstenJapan East https://japaneast.api.cognitive.microsoft.com
Korea, MitteKorea Central https://koreacentral.api.cognitive.microsoft.com
USA Nord MitteNorth Central US https://northcentralus.api.cognitive.microsoft.com
NordeuropaNorth Europe https://northeurope.api.cognitive.microsoft.com
Südafrika, NordenSouth Africa North https://southafricanorth.api.cognitive.microsoft.com
USA Süd MitteSouth Central US https://southcentralus.api.cognitive.microsoft.com
Asien, SüdostenSoutheast Asia https://southeastasia.api.cognitive.microsoft.com
UK, SüdenUK South https://uksouth.api.cognitive.microsoft.com
USA, Westen-MitteWest Central US https://westcentralus.api.cognitive.microsoft.com
Europa, WestenWest Europe https://westeurope.api.cognitive.microsoft.com
USA (Westen)West US https://westus.api.cognitive.microsoft.com
USA, Westen 2West US 2 https://westus2.api.cognitive.microsoft.com
US GovUS Gov US Government, VirginiaUS Gov Virginia https://virginia.api.cognitive.microsoft.us
ChinaChina China, Osten 2China East 2 https://chinaeast2.api.cognitive.azure.cn
China, NordenChina North https://chinanorth.api.cognitive.azure.cn

Weitere InformationenSee also