UpdateVocabulary - Transcribe

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

UpdateVocabulary

Aggiorna un vocabolario personalizzato esistente con nuovi valori. Questa operazione sovrascrive tutte le informazioni esistenti con i nuovi valori; non è possibile aggiungere nuovi termini a un vocabolario personalizzato esistente.

Sintassi della richiesta

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

Parametri della richiesta

Per informazioni sui parametri comuni a tutte le azioni, vedere Parametri comuni.

La richiesta accetta i seguenti dati in formato JSON.

LanguageCode

Il codice della lingua che rappresenta la lingua delle voci del vocabolario personalizzato che desideri aggiornare. Ogni vocabolario personalizzato deve contenere termini in una sola lingua.

Un vocabolario personalizzato può essere utilizzato solo per trascrivere file nella stessa lingua del vocabolario personalizzato. Ad esempio, se crei un vocabolario personalizzato utilizzando l'inglese americano (en-US), puoi applicare questo vocabolario personalizzato solo ai file che contengono audio in inglese.

Per un elenco delle lingue supportate e dei codici di lingua associati, consulta la tabella Lingue supportate.

Tipo: String

Valori validi: 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

Campo obbligatorio: sì

Phrases

Usa questo parametro se desideri aggiornare il tuo vocabolario personalizzato includendo tutti i termini desiderati, come valori separati da virgole, nella tua richiesta. L'altra opzione per aggiornare il vocabolario personalizzato consiste nel salvare le voci in un file di testo e caricarle in un bucket Amazon S3, quindi specificare la posizione del file utilizzando ilVocabularyFileUri parametro.

Nota che se includiPhrases nella tua richiesta, non puoi usarlaVocabularyFileUri; devi scegliere l'uno o l'altro.

Ogni lingua ha un set di caratteri che contiene tutti i caratteri consentiti per quella lingua specifica. Se utilizzi caratteri non supportati, la richiesta di filtro del vocabolario personalizzato non riesce. Consulta Set di caratteri per vocabolari personalizzati per ottenere il set di caratteri per la tua lingua.

Tipo: matrice di stringhe

Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.

Modello: .+

Required: No

VocabularyFileUri

La posizione di Amazon S3 del file di testo che contiene il vocabolario personalizzato. L'URI deve trovarsi nellaRegione AWS stessa posizione della risorsa da chiamare.

Ecco un esempio di percorso URI:s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt

Nota che se includiVocabularyFileUri nella tua richiesta, non puoi usare laPhrases bandiera; devi scegliere l'una o l'altra.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 2000.

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

Required: No

VocabularyName

Il nome del vocabolario personalizzato da aggiornare. I nomi di vocabolario personalizzati fanno distinzione tra maiuscole e minuscole.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 200.

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

Campo obbligatorio: sì

Sintassi della risposta

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

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

LanguageCode

Il codice della lingua che hai selezionato per il tuo vocabolario personalizzato.

Tipo: String

Valori validi: 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

La data e l'ora dell'ultimo aggiornamento apportato al vocabolario personalizzato specificato.

I timestamp sono nel formatoYYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. Ad esempio,2022-05-04T12:32:58.761000-07:00 rappresenta le 12:32 UTC-7 del 4 maggio 2022.

Tipo: Indicatore orario

VocabularyName

Il nome del vocabolario personalizzato aggiornato.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 200.

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

VocabularyState

Lo stato di elaborazione del tuo vocabolario personalizzato. Se lo stato èREADY, puoi utilizzare il vocabolario personalizzato in unaStartTranscriptionJob richiesta.

Tipo: String

Valori validi: PENDING | READY | FAILED

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

BadRequestException

La tua richiesta non ha superato uno o più test di convalida. Ciò può verificarsi quando l'entità che stai cercando di eliminare non esiste o se si trova in uno stato non terminale (ad esempioIN PROGRESS). Per ulteriori informazioni, consulta il campo messaggio di eccezione.

Codice di stato HTTP: 400

ConflictException

Esiste già una risorsa con questo nome. I nomi delle risorse devono essere univoci all'interno diAccount AWS.

Codice di stato HTTP: 400

InternalFailureException

Si è verificato un errore interno. Controlla il messaggio di errore, correggi il problema e riprova con la richiesta.

Codice di stato HTTP: 500

LimitExceededException

Hai inviato troppe richieste o il file di input è troppo lungo. Attendi prima di riprovare la richiesta oppure utilizza un file più piccolo e riprova la richiesta.

Codice di stato HTTP: 400

NotFoundException

Non è possibile individuare la risorsa richiesta. Verifica che il nome specificato sia corretto e riprova la richiesta.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: