[ aws . transcribe ]
update-vocabulary
Описание
Обновляет существующий пользовательский словарь новыми значениями. Данная операция перезаписывает все существующие данные новыми значениями; невозможно добавить новые термины к существующему пользовательскому словарю.
См. также: Документация API AWS
Синтаксис
update-vocabulary
--vocabulary-name <value>
--language-code <value>
[--phrases <value>]
[--vocabulary-file-uri <value>]
[--data-access-role-arn <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--vocabulary-name (строка)
--language-code (строка)
Код языка, представляющий язык записей в пользовательском словаре, который вы хотите обновить. Каждый пользовательский словарь должен содержать термины только на одном языке.
Пользовательский словарь может использоваться только для транскрибирования файлов на том же языке, что и пользовательский словарь. Например, если вы создаете пользовательский словарь на английском языке США (en-US ), вы можете применить этот пользовательский словарь только к файлам, содержащим аудио на английском языке.
Список поддерживаемых языков и соответствующих кодов языков см. в таблице Поддерживаемые языки.
Возможные значения:
af-ZAar-AEar-SAda-DKde-CHde-DEen-ABen-AUen-GBen-IEen-INen-USen-WLes-ESes-USfa-IRfr-CAfr-FRhe-ILhi-INid-IDit-ITja-JPko-KRms-MYnl-NLpt-BRpt-PTru-RUta-INte-INtr-TRzh-CNzh-TWth-THen-ZAen-NZvi-VNsv-SEab-GEast-ESaz-AZba-RUbe-BYbg-BGbn-INbs-BAca-ESckb-IQckb-IRcs-CZcy-WLel-GRet-ETeu-ESfi-FIgl-ESgu-INha-NGhr-HRhu-HUhy-AMis-ISka-GEkab-DZkk-KZkn-INky-KGlg-INlt-LTlv-LVmhr-RUmi-NZmk-MKml-INmn-MNmr-INmt-MTno-NOor-INpa-INpl-PLps-AFro-ROrw-RWsi-LKsk-SKsl-SIso-SOsr-RSsu-IDsw-BIsw-KEsw-RWsw-TZsw-UGtl-PHtt-RUug-CNuk-UAuz-UZwo-SNzh-HKzu-ZA
--phrases (список)
Используйте этот параметр, если вы хотите обновить пользовательский словарь, включив все необходимые термины в виде значений, разделенных запятыми, в запросе. Другой вариант обновления пользовательского словаря — сохранить записи в текстовом файле и загрузить их в Amazon S3, а затем указать расположение файла с помощью параметра VocabularyFileUri.
Обратите внимание, что если вы включаете Phrases в свой запрос, вы не можете использовать VocabularyFileUri; вы должны выбрать один из вариантов.
Каждый язык имеет набор символов, содержащий все разрешенные символы для этого конкретного языка. Если вы используете недопустимые символы, запрос фильтра пользовательского словаря завершается ошибкой. См. Раздел «Наборы символов для пользовательских словарей», чтобы получить набор символов для вашего языка.
(строка)
Синтаксис:
"string" "string" ...
--vocabulary-file-uri (строка)
Расположение текстового файла в Amazon S3, содержащего ваш пользовательский словарь. URI должен находиться в той же области Amazon Web Services, что и вызываемый ресурс.
Вот пример пути URI: s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt
Обратите внимание, что если вы включаете VocabularyFileUri в свой запрос, вы не можете использовать флаг Phrases; вы должны выбрать один из вариантов.
--data-access-role-arn (строка)
Amazon Resource Name (ARN) роли IAM, имеющей разрешения на доступ к Amazon S3-хранилищу, содержащему ваши входные файлы (в данном случае — ваш пользовательский словарь). Если у указанной роли недостаточно прав доступа к указанному расположению в Amazon S3, запрос завершается ошибкой.
ARN ролей IAM имеют формат arn:partition:iam::account:role/role-name-with-path . Например: arn:aws:iam::111122223333:role/Admin .
Для получения дополнительной информации см. IAM ARNs.
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передать произвольные двоичные значения с помощью значения, предоставленного в JSON, поскольку строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит каркас JSON в стандартный вывод без отправки запроса API. Если указано без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если указано значение output, он проверит входные данные команд и вернет пример выходного JSON для этой команды. Сгенерированный каркас JSON не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном каркасе JSON.
Глобальные параметры
--debug (булево)
Включить отладку.
--endpoint-url (строка)
Переопределить URL по умолчанию команды указанным URL.
--no-verify-ssl (булево)
По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение по умолчанию, связанное с проверкой сертификатов SSL.
--no-paginate (булево)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования вывода команды.
- json
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Используемая область. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/отключить цветной вывод.
- включить
- отключить
- автоматически
--no-sign-request (булево)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения к сокету в секундах. Если значение установлено в 0, подключение к сокету будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной в base64 строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет рассматриваться как двоичный и использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (булево)
Отключить пагинатор cli для вывода.
--cli-auto-prompt (булево)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическое запросить параметры ввода CLI.
Примеры
Примечание
Чтобы использовать следующие примеры, у вас должен быть установлен и настроен AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, во всех примерах используются правила цитирования в стиле Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. раздел Использование кавычек со строками в Руководстве пользователя AWS CLI.
Чтобы обновить пользовательский словарь новыми терминами.
Следующий update-vocabulary пример перезаписывает термины, используемые для создания пользовательского словаря, на новые, которые вы предоставляете. Предварительное условие: для замены терминов в пользовательском словаре вам нужен файл с новыми терминами.
aws transcribe update-vocabulary \
--vocabulary-file-uri s3://amzn-s3-demo-bucket/Amazon-S3-Prefix/custom-vocabulary.txt \
--vocabulary-name custom-vocabulary \
--language-code language-code
Вывод:
{
"VocabularyName": "custom-vocabulary",
"LanguageCode": "language",
"VocabularyState": "PENDING"
}
Дополнительную информацию см. в разделе Пользовательские словари в Руководстве разработчика Amazon Transcribe.
Вывод
VocabularyName -> (строка)
LanguageCode -> (строка)
LastModifiedTime -> (метка времени)
Дата и время последнего обновления указанного пользовательского словаря.
Метки времени имеют формат YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC . Например, 2022-05-04T12:32:58.761000-07:00 соответствует 12:32 пополудни UTC-7 4 мая 2022 года.
VocabularyState -> (строка)
READY, вы можете использовать пользовательский словарь в запросе StartTranscriptionJob.
© Copyright 2025, Amazon Web Services. Created using Sphinx.