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 des
VocabularyFileUri
Parameters an.Beachten Sie, dass Sie, wenn Sie dies
Phrases
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 die
Phrases
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 Format
YYYY-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 ist
READY
, 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: