Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# UpdateVocabulary
Actualiza un vocabulario personalizado existente con nuevos valores. Esta operación sobrescribe toda la información existente con los nuevos valores; no puede añadir nuevos términos a un vocabulario personalizado existente.
## Sintaxis de la solicitud
```
{
"LanguageCode": "string",
"Phrases": [ "string" ],
"VocabularyFileUri": "string",
"VocabularyName": "string"
}
```
## Parámetros de solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).
La solicitud acepta los siguientes datos en formato JSON.
** [LanguageCode](#API_UpdateVocabulary_RequestSyntax) **
El código de idioma que representa el idioma de las entradas del vocabulario personalizado que desea actualizar. Cada vocabulario personalizado debe contener términos en un solo idioma.
Un vocabulario personalizado solo se puede usar para transcribir archivos en el mismo idioma que el vocabulario personalizado. Por ejemplo, si crea un vocabulario personalizado con inglés estadounidense (`en-US`), solo puede aplicar este vocabulario personalizado a archivos que contengan audio en inglés.
Para obtener una lista de los idiomas admitidos y sus códigos de idioma asociados, consulte la tabla de [idiomas admitidos](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html).
Tipo: cadena
Valores válidos:` 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`
Obligatorio: sí
** [Phrases](#API_UpdateVocabulary_RequestSyntax) **
Utilice este parámetro si desea actualizar su vocabulario personalizado e incluir todos los términos que desee, como valores separados por comas, en su solicitud. La otra opción para actualizar el vocabulario personalizado consiste en guardar las entradas en un archivo de texto y subirlas a un bucket de Amazon S3 y, a continuación, especificar la ubicación del archivo mediante el`VocabularyFileUri` parámetro.
Tenga en cuenta que si lo incluye`Phrases` en su solicitud, no puede usarlo`VocabularyFileUri`; debe elegir uno u otro.
Cada idioma tiene un conjunto de caracteres que contiene todos los caracteres permitidos para ese idioma específico. Si utilizas caracteres no admitidos, se producirá un error en tu solicitud de filtro de vocabulario personalizado. Consulte [Conjuntos de caracteres para obtener vocabulario personalizado](https://docs.aws.amazon.com/transcribe/latest/dg/charsets.html) para obtener el conjunto de caracteres de su idioma.
Tipo: matriz de cadenas
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.
Patrón: `.+`
Obligatorio: no
** [VocabularyFileUri](#API_UpdateVocabulary_RequestSyntax) **
La ubicación de Amazon S3 del archivo de texto que contiene el vocabulario personalizado. La URI debe encontrarse en el mismo lugarRegión de AWS que el recurso al que está llamando.
A continuación se muestra un ejemplo de ruta de URI:`s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt`
Tenga en cuenta que si lo incluye`VocabularyFileUri` en su solicitud, no puede`Phrases` usar la marca; debe elegir una u otra.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2000 caracteres.
Patrón: `(s3://|http(s*)://).+`
Obligatorio: no
** [VocabularyName](#API_UpdateVocabulary_RequestSyntax) **
Nombre del vocabulario personalizado que desea actualizar. Los nombres de vocabulario personalizados distinguen entre mayúsculas y minúsculas.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 200 caracteres.
Patrón: `^[0-9a-zA-Z._-]+`
Obligatorio: sí
## Sintaxis de la respuesta
```
{
"LanguageCode": "string",
"LastModifiedTime": number,
"VocabularyName": "string",
"VocabularyState": "string"
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [LanguageCode](#API_UpdateVocabulary_ResponseSyntax) **
El código de idioma que seleccionaste para tu vocabulario personalizado.
Tipo: cadena
Valores válidos:` 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](#API_UpdateVocabulary_ResponseSyntax) **
La fecha y hora en la que se actualizó por última vez el vocabulario personalizado especificado.
Las marcas de tiempo están en el formato`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`. Por ejemplo,`2022-05-04T12:32:58.761000-07:00` representa a las 12:32 p. m., hora peninsular española, del 4 de mayo de 2022.
Tipo: marca temporal
** [VocabularyName](#API_UpdateVocabulary_ResponseSyntax) **
Nombre del vocabulario personalizado actualizado.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 200 caracteres.
Patrón: `^[0-9a-zA-Z._-]+`
** [VocabularyState](#API_UpdateVocabulary_ResponseSyntax) **
El estado de procesamiento de tu vocabulario personalizado. Si el estado lo es`READY`, puedes usar el vocabulario personalizado en una`StartTranscriptionJob` solicitud.
Tipo: cadena
Valores válidos:` PENDING | READY | FAILED`
## Errores
Para obtener información sobre los errores comunes a todas las acciones, consulte[Errores comunes](CommonErrors.md).
** BadRequestException **
Tu solicitud no ha superado una o más pruebas de validación. Esto puede ocurrir cuando la entidad que intentas eliminar no existe o si se encuentra en un estado no terminal (por ejemplo`IN PROGRESS`). Para obtener más información, consulte el campo de mensaje de excepción.
Código de estado HTTP: 400
** ConflictException **
Ya existe un recurso con este nombre. Los nombres de recurso deben ser únicos dentro deCuenta de AWS.
Código de estado HTTP: 400
** InternalFailureException **
Se produjo un error interno. Compruebe el mensaje de error, resuelva el problema e inténtelo de nuevo.
Código de estado HTTP: 500
** LimitExceededException **
Has enviado demasiadas solicitudes o tu archivo de entrada es demasiado largo. Espere antes de volver a intentar la solicitud o utilice un archivo más pequeño y vuelva a intentarlo.
Código de estado HTTP: 400
** NotFoundException **
No encontramos el recurso solicitado. Compruebe que el nombre especificado es correcto e intente realizar la solicitud de nuevo.
Código de estado HTTP: 400
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/UpdateVocabulary)
+ [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/UpdateVocabulary)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/UpdateVocabulary)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/UpdateVocabulary)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/UpdateVocabulary)
+ [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/UpdateVocabulary)
+ [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/UpdateVocabulary)
+ [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/UpdateVocabulary)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/UpdateVocabulary)