Spec-Zone.ru › AWS CLI v2

[ aws . transcribe ]

create-vocabulary-filter

Описание

Создаёт новый пользовательский фильтр словаря.

Вы можете использовать пользовательские фильтры словарей для маскирования, удаления или пометки определённых слов в вашем транскрипте. Пользовательские фильтры словарей обычно используются для маскирования ненормативной лексики в транскриптах.

Каждый язык имеет набор символов, содержащий все разрешённые символы для этого конкретного языка. Если вы используете недопустимые символы, запрос вашего пользовательского фильтра словаря завершится ошибкой. Обратитесь к набору символов для пользовательских словарей, чтобы получить набор символов для вашего языка.

Дополнительную информацию см. в разделе Фильтрование словарей.

См. также: Документацию API AWS

Синтаксис

  create-vocabulary-filter
--vocabulary-filter-name <value>
--language-code <value>
[--words <value>]
[--vocabulary-filter-file-uri <value>]
[--tags <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-filter-name (строка)

Уникальное имя, выбранное вами, для вашего нового пользовательского фильтра словаря.

Это имя чувствительно к регистру, не может содержать пробелы и должно быть уникальным в рамках учётной записи Amazon Web Services. Если вы попытаетесь создать новый пользовательский фильтр словаря с тем же именем, что и существующий пользовательский фильтр словаря, появится ошибка ConflictException.

--language-code (строка)

Код языка, представляющий язык записей в вашем фильтре словаря. Каждый пользовательский фильтр словаря должен содержать термины только на одном языке.

Пользовательский фильтр словаря может использоваться только для транскрипции файлов на том же языке, что и фильтр. Например, если вы создаёте пользовательский фильтр словаря, используя американский английский (en-US), вы можете применить этот фильтр только к файлам, содержащим аудио на английском языке.

Список поддерживаемых языков и соответствующих кодов языков см. в таблице Поддерживаемые языки.

Возможные значения:

  • 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
  • ab-GE
  • ast-ES
  • az-AZ
  • ba-RU
  • be-BY
  • bg-BG
  • bn-IN
  • bs-BA
  • ca-ES
  • ckb-IQ
  • ckb-IR
  • cs-CZ
  • cy-WL
  • el-GR
  • et-ET
  • eu-ES
  • fi-FI
  • gl-ES
  • gu-IN
  • ha-NG
  • hr-HR
  • hu-HU
  • hy-AM
  • is-IS
  • ka-GE
  • kab-DZ
  • kk-KZ
  • kn-IN
  • ky-KG
  • lg-IN
  • lt-LT
  • lv-LV
  • mhr-RU
  • mi-NZ
  • mk-MK
  • ml-IN
  • mn-MN
  • mr-IN
  • mt-MT
  • no-NO
  • or-IN
  • pa-IN
  • pl-PL
  • ps-AF
  • ro-RO
  • rw-RW
  • si-LK
  • sk-SK
  • sl-SI
  • so-SO
  • sr-RS
  • su-ID
  • sw-BI
  • sw-KE
  • sw-RW
  • sw-TZ
  • sw-UG
  • tl-PH
  • tt-RU
  • ug-CN
  • uk-UA
  • uz-UZ
  • wo-SN
  • zh-HK
  • zu-ZA

--words (список)

Используйте этот параметр, если хотите создать свой пользовательский фильтр словаря, включив все необходимые термины в виде значений, разделённых запятыми, в свой запрос. Другой вариант создания фильтра словаря — сохранение записей в текстовом файле и загрузка их в ведро Amazon S3, а затем указание местоположения файла с помощью параметра VocabularyFilterFileUri.

Обратите внимание, что если вы включаете Words в свой запрос, вы не можете использовать VocabularyFilterFileUri; вы должны выбрать один из вариантов.

Каждый язык имеет набор символов, содержащий все разрешённые символы для этого конкретного языка. Если вы используете недопустимые символы, запрос вашего пользовательского фильтра словаря завершится ошибкой. Обратитесь к набору символов для пользовательских словарей, чтобы получить набор символов для вашего языка.

(строка)

Синтаксис:

"string" "string" ...

--vocabulary-filter-file-uri (строка)

Местоположение файла Amazon S3 в текстовом формате, содержащем термины вашего пользовательского фильтра словаря. URI должен находиться в том же регионе Amazon Web Services, что и вызываемый ресурс.

Вот пример пути URI: s3://DOC-EXAMPLE-BUCKET/my-vocab-filter-file.txt

Обратите внимание, что если вы включаете VocabularyFilterFileUri в свой запрос, вы не можете использовать Words; вы должны выбрать один из вариантов.

--tags (список)

Добавляет один или несколько пользовательских тегов, каждый в формате пары «ключ:значение», к новому пользовательскому фильтру словаря при его создании.

Дополнительную информацию об использовании тегов с Amazon Transcribe см. в разделе Тегирование ресурсов.

(структура)

Добавляет метаданные в формате пары «ключ:значение» к указанному ресурсу.

Например, вы можете добавить тег Department:Sales к ресурсу, чтобы указать, что он относится к отделу продаж вашей организации. Вы также можете использовать теги для управления доступом на основе тегов.

Дополнительную информацию о тегах см. в разделе Тегирование ресурсов.

Ключ -> (строка)

Первая часть пары «ключ:значение», которая образует тег, связанный с данным ресурсом. Например, в теге Department:Sales ключ — это «Отдел».

Значение -> (строка)

Вторая часть пары «ключ:значение», которая образует тег, связанный с данным ресурсом. Например, в теге Department:Sales значение — это «Продажи».

Обратите внимание, что вы можете установить значение тега в пустую строку, но не можете установить его в значение null. Пропуск значения тега эквивалентен использованию пустой строки.

Сокращённый синтаксис:

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--data-access-role-arn (строка)

Идентификатор ресурса Amazon (ARN) роли IAM, имеющей разрешения на доступ к ведру Amazon S3, содержащему входные файлы (в данном случае, ваш пользовательский фильтр словаря). Если у указанной роли нет соответствующих разрешений на доступ к указанному расположению в Amazon S3, ваш запрос завершится ошибкой.

ARN ролей IAM имеют формат arn:partition:iam::account:role/role-name-with-path. Например: arn:aws:iam::111122223333:role/Admin.

Дополнительную информацию см. в разделе ARN IAM.

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON следует формату, указанному в --generate-cli-skeleton. Если другие аргументы указаны в командной строке, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные данные с помощью значения, предоставленного в JSON, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит каркас JSON в стандартный вывод без отправки запроса API. Если предоставлено значение null или значение input, выводит пример входного JSON, который можно использовать как аргумент для --cli-input-json. Аналогично, если предоставлено значение yaml-input, выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, он проверит входные данные команд и вернёт пример выходного JSON для этой команды. Сгенерированный каркас JSON не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном каркасе JSON.

Общие параметры

--debug (boolean)

Включить отладку логирования.

--endpoint-url (string)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команд.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определённый профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки конфигурации/окружения.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/отключить вывод цвета.

  • on
  • off
  • auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/окружения.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (string)

Стиль форматирования для бинарных блоков. По умолчанию используется формат 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 (boolean)

Отключить паджинг для вывода.

--cli-auto-prompt (boolean)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматический запрос параметров ввода CLI.

Примеры

Примечание

Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования, подобные UNIX. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Создание фильтра словаря

Следующий create-vocabulary-filter пример создает фильтр словаря, использующий текстовый файл, содержащий список слов, которые не должны появляться в транскрипции. Для языка укажите язык, соответствующий языку вашего фильтра словаря. Для URI файла фильтра словаря укажите URI Amazon S3 текстового файла. Для имени фильтра словаря укажите имя вашего фильтра словаря.

aws transcribe create-vocabulary-filter \
    --language-code language-code \
    --vocabulary-filter-file-uri s3://amzn-s3-demo-bucket/vocabulary-filter.txt \
    --vocabulary-filter-name cli-vocabulary-filter-example

Вывод:

{
    "VocabularyFilterName": "cli-vocabulary-filter-example",
    "LanguageCode": "language-code"
}

Дополнительную информацию см. в разделе Фильтрация нежелательных слов в Руководстве разработчика Amazon Transcribe.

Вывод

VocabularyFilterName -> (строка)

Название вашего пользовательского фильтра словаря.

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 года.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API