UpdateVocabulary - Transcribe
AnforderungssyntaxAnfrageparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

UpdateVocabulary

Aktualisiert ein vorhandenes benutzerdefiniertes Vokabular mit neuen Werten. Dieser Vorgang überschreibt alle vorhandenen Informationen mit Ihren neuen Werten. Sie können einem vorhandenen benutzerdefinierten Vokabular keine neuen Begriffe anhängen.

Anforderungssyntax

{
   "LanguageCode": "string",
   "Phrases": [ "string" ],
   "VocabularyFileUri": "string",
   "VocabularyName": "string"
}

Anfrageparameter

Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

LanguageCode

Der Sprachcode, der die Sprache der Einträge im benutzerdefinierten Vokabular darstellt, das Sie aktualisieren möchten. Jedes benutzerdefinierte Vokabular darf Begriffe in nur einer Sprache enthalten.

Ein benutzerdefiniertes Vokabular kann nur verwendet werden, um Dateien in derselben Sprache wie das benutzerdefinierte Vokabular zu transkribieren. Wenn Sie beispielsweise ein benutzerdefiniertes Vokabular mit US-Englisch (en-US) erstellen, können Sie dieses benutzerdefinierte Vokabular nur auf Dateien anwenden, die englische Audiodateien enthalten.

Eine Liste der unterstützten Sprachen und der zugehörigen Sprachcodes finden Sie in der Tabelle Unterstützte Sprachen.

Typ: Zeichenfolge

Zulässige Werte: af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE

Erforderlich: Ja

Phrases

Verwenden Sie diesen Parameter, wenn Sie Ihr benutzerdefiniertes Vokabular aktualisieren möchten, indem Sie alle gewünschten Begriffe als kommagetrennte Werte in Ihre Anfrage aufnehmen. Die andere Möglichkeit, Ihr benutzerdefiniertes Vokabular zu aktualisieren, besteht darin, Ihre Einträge in einer Textdatei zu speichern und sie in einen Amazon S3 S3-Bucket hochzuladen. Geben Sie dann den Speicherort Ihrer Datei mithilfe desVocabularyFileUri Parameters an.

Beachten Sie, dass Sie, wenn Sie diesPhrases in Ihrer Anfrage angeben, nicht verwendenVocabularyFileUri können. Sie müssen das eine oder das andere wählen.

Jede Sprache hat einen Zeichensatz, der alle zulässigen Zeichen für diese bestimmte Sprache enthält. Wenn Sie Zeichen verwenden, die nicht unterstützt werden, schlägt Ihre benutzerdefinierte Vokabelfilteranfrage fehl. Unter Zeichensätze für benutzerdefinierte Vokabeln finden Sie den Zeichensatz für Ihre Sprache.

Typ: Zeichenfolge-Array

Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen.

Pattern: .+

Erforderlich: Nein

VocabularyFileUri

Der Amazon-S3-Speicherort der Textdatei, die Ihren benutzerdefinierten Wortschatz enthält. Die URI muss sich in derselbenAWS-Region wie die von Ihnen aufgerufene Ressource befinden.

Ein Beispiel für einen URI-Pfad:s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt

Beachten Sie, dass Sie diePhrases Flagge nicht verwenden können, wenn Sie diesVocabularyFileUri in Ihrer Anfrage angeben. Sie müssen das eine oder das andere auswählen.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Maximale Länge von 2000.

Pattern: (s3://|http(s*)://).+

Erforderlich: Nein

VocabularyName

Der Name des benutzerdefinierten Vokabulars, das Sie aktualisieren möchten. Namen von benutzerdefinierten Vokabularen unterscheiden zwischen Groß- und Kleinschreibung.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 200 Zeichen.

Pattern: ^[0-9a-zA-Z._-]+

Erforderlich: Ja

Antwortsyntax

{
   "LanguageCode": "string",
   "LastModifiedTime": number,
   "VocabularyName": "string",
   "VocabularyState": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

LanguageCode

Der Sprachcode, den Sie für Ihr benutzerdefiniertes Vokabular ausgewählt haben.

Typ: Zeichenfolge

Zulässige Werte: af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE

LastModifiedTime

Das Datum und die Uhrzeit der letzten Aktualisierung des angegebenen benutzerdefinierten Vokabulars.

Zeitstempel haben das FormatYYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. Steht beispielsweise2022-05-04T12:32:58.761000-07:00 für 12:32 Uhr UTC-7 am 4. Mai 2022.

Typ: Zeitstempel

VocabularyName

Der Name des aktualisierten benutzerdefinierten Vokabulars.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 200 Zeichen.

Pattern: ^[0-9a-zA-Z._-]+

VocabularyState

Der Verarbeitungsstatus Ihres benutzerdefinierten Vokabulars. Wenn das Bundesland istREADY, können Sie das benutzerdefinierte Vokabular in einerStartTranscriptionJob Anfrage verwenden.

Typ: Zeichenfolge

Zulässige Werte: PENDING | READY | FAILED

Fehler

Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehler.

BadRequestException

Ihre Anfrage hat einen oder mehrere Validierungstests nicht bestanden. Dies kann vorkommen, wenn die Entität, die Sie löschen möchten, nicht existiert oder wenn sie sich in einem nicht terminalen Zustand befindet (z. B.IN PROGRESS). Weitere Informationen finden Sie im Feld mit einer Ausnahmemeldung.

HTTP Status Code: 400

ConflictException

Eine Ressource mit diesem Namen ist bereits vorhanden. Ressourcennamen müssen innerhalb einesAWS-Konto ------------

HTTP Status Code: 400

InternalFailureException

Es ist ein interner Fehler aufgetreten. Überprüfen Sie die Fehlermeldung, lösen Sie das Problem und versuchen Sie Ihre Anfrage erneut.

HTTP Status Code: 500

LimitExceededException

Sie haben entweder zu viele Anfragen gesendet oder Ihre Eingabedatei ist zu lang. Warten Sie, bevor Sie Ihre Anfrage wiederholen, oder verwenden Sie eine kleinere Datei und versuchen Sie es erneut.

HTTP Status Code: 400

NotFoundException

Wir können die angeforderte Ressource nicht finden. Überprüfen Sie, ob der angegebene Name korrekt ist, und versuchen Sie Ihre Anfrage erneut.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: