Erstellen einer Translator-Ressource

Sie benötigen ein aktives Azure-Konto, um zu beginnen. Wenn Sie kein Konto besitzen, können Sie ein kostenloses 12-monatiges Abonnement erstellen.

Mit Ihrem Azure-Konto können Sie über zwei verschiedene Ressourcentypen auf den Übersetzerdienst zugreifen:

1. Ressourcentypen für einzelne Dienste ermöglichen den Zugriff auf einen API-Schlüssel und einen Endpunkt für einen einzelnen Dienst.

2. Ressourcentypen für mehrere Dienste ermöglichen den Zugriff auf mehrere Azure AI Services-Instanzen über einen einzelnen API-Schlüssel und Endpunkt.

Nachdem Sie entschieden haben, welchen Ressourcentyp Sie für den Zugriff auf den Übersetzerdienst verwenden möchten, können Sie die Details für Ihr Projekt und ihre Instanz eingeben.

1. Abonnement. Wählen Sie eines Ihrer verfügbaren Azure-Abonnements aus.

2. Ressourcengruppe: Sie können eine neue Ressourcengruppe erstellen oder Ihre Ressource zu einer bereits vorhandenen Ressourcengruppe hinzufügen, die denselben Lebenszyklus, dieselben Berechtigungen und dieselben Richtlinien aufweist.

3. Ressourcenregion: Wählen Sie die Option Global aus, es sei denn, Ihr Unternehmen oder Ihre Anwendung erfordert eine spezifische Region. Wenn Sie planen, das Dokumentübersetzungs-Feature mit Authentifizierung mittels verwalteter Identitäten zu verwenden, wählen Sie eine geografische Region aus, z. B. USA, Osten.

4. Name Geben Sie einen Namen für Ihre Ressource ein. Der ausgewählte Name muss innerhalb von Azure eindeutig sein.

   Hinweis

   Wenn Sie ein Übersetzerfeature verwenden, das einen benutzerdefinierten Domänen-Endpunkt erfordert, z. B. die Dokumentübersetzung, entspricht der Wert, den Sie in das Feld „Name“ eingeben, dem benutzerdefinierten Domänen-Namenparameter für den Endpunkt.

5. Tarif: Wählen Sie einen Tarif aus, der Ihre Anforderungen erfüllt:

   • Jedes Abonnement verfügt über einen Free-Tarif.
   • Der Free-Tarif bietet dieselben Features und Funktionen wie die kostenpflichtigen Tarife, und er läuft nicht ab.
   • Pro Abonnement ist nur eine Free-Tarif-Ressource verfügbar.
   • Die Dokumentübersetzung wird in kostenpflichtigen Tarifen unterstützt. Language Studio unterstützt nur die S1- oder D3-Instanzebenen. Wenn Sie nur die Dokumentübersetzung ausprobieren möchten, wählen Sie die Standardinstanzebene S1 aus.

6. Wenn Sie eine Ressource mit mehreren Diensten erstellen, erhalten Sie über die Links unten auf der Registerkarte Grundlagen technische Dokumentation zum geeigneten Betrieb des Diensts.

7. Klicken Sie auf Überprüfen + erstellen.

8. Lesen Sie die Nutzungsbedingungen, und klicken Sie auf Erstellen, um Ihre Ressource bereitzustellen.

9. Nachdem Ihre Ressource erfolgreich bereitgestellt wurde, klicken Sie auf Zu Ressource wechseln.

   Authentifizierungsschlüssel und Endpunkt-URL

   Alle Azure KI Services-API-Anforderungen erfordern eine Endpunkt-URL und einen schreibgeschützten Schlüssel für die Authentifizierung.

   • Authentifizierungsschlüssel: Bei dem Schlüssel handelt es sich um eine eindeutige Zeichenfolge, die mit jeder Anforderung an den Übersetzerdienst übergeben wird. Sie können Ihren Schlüssel über einen Abfragezeichenfolgenparameter übergeben, oder indem Sie ihn im HTTP-Anforderungsheader angeben.

   • Endpunkt-URL: Verwenden Sie den globalen Endpunkt in Ihrer API-Anforderung, es sei denn, Sie benötigen eine spezifische Azure-Region oder einen benutzerdefinierten Endpunkt. Weitere Informationen finden Sie unter Basis-URLs. Die globale Endpunkt-URL lautet api.cognitive.microsofttranslator.com.

Um Ihre Verbindung mit Ihrer Übersetzerressource zu authentifizieren, müssen Sie die Schlüssel und den Endpunkt finden.

1. Nachdem Ihre neue Ressource bereitgestellt wurde, klicken Sie auf Zu Ressource wechseln, oder wechseln Sie direkt zu Ihrer Ressourcenseite.

2. Wählen Sie im linken Navigationsbereich unter Ressourcenverwaltung die Option Schlüssel und Endpunkt aus.

3. Kopieren Sie Ihre Schlüssel und Endpunkt-URL an einen praktischen Speicherort, z. B. in den Editor.

   

Die Textübersetzung unterstützt sowohl globale als auch regionale Endpunkte. Wenn Sie über Ihre Authentifizierungsschlüssel verfügen, müssen Sie mithilfe von AzureKeyCredential für die Authentifizierung eine Instanz des TextTranslationClient erstellen, um mit dem Textübersetzungsdienst zu interagieren:

1. Zum Erstellen eines TextTranslationClient mithilfe eines globalen Ressourcenendpunkts benötigen Sie Ihren Ressourcen-API-Schlüssel:

     AzureKeyCredential credential = new('<apiKey>');
     TextTranslationClient client = new(credential);
   

2. Zum Erstellen eines TextTranslationClient mithilfe eines regionalen Ressourcenendpunkts benötigen Sie Ihren Ressourcen-API-Schlüssel und den Namen der Region, in der sich die Ressource befindet:

   AzureKeyCredential credential = new('<apiKey>');
   TextTranslationClient client = new(credential, '<region>');
   

So löschen Sie die Ressource:

1. Suchen und wählen Sie Ressourcengruppen im Azure-Portal aus, und wählen Sie Ihre Ressourcengruppe aus.

2. Wählen Sie die zu löschenden Ressourcen aus, indem Sie das zugehörige Kontrollkästchen aktivieren.

3. Klicken Sie im oberen Menü am rechten Rand auf Löschen.

4. Geben Sie Löschen im Dialogfeld Ressourcen löschen ein.

5. Klicken Sie auf Löschen.

So löschen Sie die Ressourcengruppe:

1. Navigieren Sie im Azure-Portal zu Ihrer Ressourcengruppe.

2. Wählen Sie im Menü oben Ressourcengruppe löschen aus.

3. Bestätigen Sie die Löschanforderung, indem Sie den Ressourcengruppennamen eingeben und auf Löschen klicken.