UpdateVocabularyFilter - 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.

UpdateVocabularyFilter

Aktualisiert einen vorhandenen benutzerdefinierten Vokabelfilter mit einer neuen Wortliste. Die neue Liste, die Sie angeben, überschreibt alle vorherigen Einträge. Sie können keine neuen Begriffe an einen vorhandenen benutzerdefinierten Vokabelfilter anhängen.

Anforderungssyntax

{
   "VocabularyFilterFileUri": "string",
   "VocabularyFilterName": "string",
   "Words": [ "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.

VocabularyFilterFileUri

Der Amazon S3 S3-Speicherort der Textdatei, die Ihre benutzerdefinierten Vokabelfilterbegriffe enthält. Die URI muss sich in derselbenAWS-Region wie die Ressource befinden, die Sie aufrufen.

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

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

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 2000 000 Zeichen.

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

Erforderlich: Nein

VocabularyFilterName

Der Name des benutzerdefinierten Vokabelfilters, den Sie aktualisieren möchten. Bei Namen von benutzerdefinierten Vokabularfiltern wird zwischen Groß- und Kleinschreibung unterschieden.

Typ: Zeichenfolge

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

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

Erforderlich: Ja

Words

Verwenden Sie diesen Parameter, wenn Sie Ihren benutzerdefinierten Vokabelfilter aktualisieren möchten, indem Sie alle gewünschten Begriffe als kommagetrennte Werte in Ihre Anfrage aufnehmen. Die andere Möglichkeit, Ihren Vokabelfilter 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 desVocabularyFilterFileUri Parameters an.

Beachten Sie, dass Sie, wenn Sie diesWords in Ihrer Anfrage angeben, nicht verwendenVocabularyFilterFileUri 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

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element.

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

Erforderlich: Nein

Antwortsyntax

{
   "LanguageCode": "string",
   "LastModifiedTime": number,
   "VocabularyFilterName": "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 Ihren benutzerdefinierten Vokabelfilter 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 Vokabelfilters.

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

VocabularyFilterName

Der Name des aktualisierten Filters für benutzerdefinierte Vokabeln.

Typ: Zeichenfolge

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

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

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 für eine Ausnahmemeldung.

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: