start-text-translation-job
Описание
Запускает асинхронную задачу по пакетному переводу. Используйте задачи пакетного перевода для перевода больших объёмов текста по множеству документов одновременно. Для пакетного перевода вы можете ввести документы с разными исходными языками (укажите auto как исходный язык). Вы можете указать один или несколько целевых языков. Пакетный перевод переводит каждый входной документ на каждый из целевых языков. Дополнительная информация доступна в разделе Асинхронная обработка пакетных задач .
Задачи пакетного перевода могут быть описаны операцией DescribeTextTranslationJob, перечислены операцией ListTextTranslationJobs и остановлены операцией StopTextTranslationJob.
См. также: Документация AWS API
Синтаксис
start-text-translation-job
[--job-name <value>]
--input-data-config <value>
--output-data-config <value>
--data-access-role-arn <value>
--source-language-code <value>
--target-language-codes <value>
[--terminology-names <value>]
[--parallel-data-names <value>]
[--client-token <value>]
[--settings <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]
Параметры
--job-name (строка)
--input-data-config (структура)
Указывает формат и расположение входных документов для задачи перевода.
S3Uri -> (строка)
ContentType -> (строка)
Описание формата данных, которые вы предоставляете Amazon Translate в качестве входных данных. Вы можете указать один из следующих типов MIME:
-
text/html: Входные данные состоят из одного или нескольких HTML-файлов. Amazon Translate переводит только текст, находящийся в элементеhtmlв каждом файле. -
text/plain: Входные данные состоят из одного или нескольких текстовых файлов без форматирования. Amazon Translate переводит каждый символ в этом типе входных данных. -
application/vnd.openxmlformats-officedocument.wordprocessingml.document: Входные данные состоят из одного или нескольких документов Word (.docx). -
application/vnd.openxmlformats-officedocument.presentationml.presentation: Входные данные состоят из одного или нескольких файлов презентаций PowerPoint (.pptx). -
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet: Входные данные состоят из одного или нескольких файлов книги Excel (.xlsx). -
application/x-xliff+xml: Входные данные состоят из одного или нескольких файлов формата XLIFF (XML Localization Interchange File Format) (.xlf). Amazon Translate поддерживает только версию XLIFF 1.2.
Предупреждение
Если вы структурируете свои входные данные как HTML, убедитесь, что вы установили этот параметр вtext/html . Это позволит сократить расходы, ограничивая перевод содержимым элемента html в каждом файле. В противном случае, если вы установите этот параметр в text/plain, ваши затраты будут покрывать перевод каждого символа.Краткая запись:
S3Uri=string,ContentType=string
Синтаксис JSON:
{
"S3Uri": "string",
"ContentType": "string"
}
--output-data-config (структура)
Указывает папку S3, в которую будет сохранён выходной результат вашей задачи.
S3Uri -> (строка)
EncryptionKey -> (структура)
Шифровальный ключ, используемый для шифрования этого объекта.
Type -> (строка)
Id -> (строка)
Краткая запись:
S3Uri=string,EncryptionKey={Type=string,Id=string}
Синтаксис JSON:
{
"S3Uri": "string",
"EncryptionKey": {
"Type": "KMS",
"Id": "string"
}
}
--data-access-role-arn (строка)
--source-language-code (строка)
auto . Amazon Translate автоматически определяет исходный язык для каждого входного документа. Список поддерживаемых кодов языков см. в разделе Поддерживаемые языки .--target-language-codes (список)
Целевые языки задачи перевода. Введите до 10 кодов языков. Каждый входной файл переводится на каждый целевой язык.
Каждый код языка состоит из 2 или 5 символов. Список кодов языков см. в разделе Поддерживаемые языки .
(строка)
Синтаксис:
"string" "string" ...
--terminology-names (список)
Имя ресурса пользовательской терминологии, который необходимо добавить в задачу перевода. Этот ресурс перечисляет примеры исходных терминов и желаемый перевод для каждого термина.
Этот параметр принимает только один ресурс пользовательской терминологии.
Если вы указываете несколько целевых языков для задачи, Amazon Translate использует назначенную терминологию для каждого запрошенного целевого языка, который содержит запись для исходного термина в файле терминологии.
Список доступных ресурсов пользовательской терминологии можно получить, используя операцию ListTerminologies.
Дополнительная информация доступна в разделе Пользовательская терминология .
(строка)
Синтаксис:
"string" "string" ...
--parallel-data-names (список)
Имя ресурса параллельных данных для добавления в задачу перевода. Этот ресурс состоит из примеров, которые показывают, как вы хотите переводить фрагменты текста. Если вы указываете несколько целевых языков для задачи, файл параллельных данных должен включать переводы для всех целевых языков.
При добавлении параллельных данных в задачу перевода вы создаёте задачу Активного пользовательского перевода.
Этот параметр принимает только один ресурс параллельных данных.
Примечание
Задачи Активного пользовательского перевода имеют более высокую стоимость, чем другие задачи, не использующие параллельные данные. Дополнительная информация доступна в разделе Цены Amazon Translate .Список доступных ресурсов параллельных данных можно получить, используя операцию ListParallelData.
Дополнительная информация доступна в разделе Настройка переводов с помощью параллельных данных .
(строка)
Синтаксис:
"string" "string" ...
--client-token (строка)
--settings (структура)
Настройки для настройки выходных данных перевода. Вы можете настроить следующие параметры:
- Краткие формы: не поддерживается.
- Формальность: устанавливает уровень формальности выходного текста.
- Маскировка ненормативной лексики: маскирует ненормативную лексику и фразы в выходном переводе.
Формальность -> (строка)
Вы можете указать желаемый уровень формальности для переводов на поддерживаемые целевые языки. Настройка формальности контролирует уровень использования формального языка (также известного как регистр) в выходном переводе. Вы можете установить значение в неофициальное или формальное. Если вы не указываете значение для формальности или целевой язык не поддерживает формальность, перевод проигнорирует настройку формальности.
Если вы указываете несколько целевых языков для задачи, Amazon Translate проигнорирует настройку формальности для любого языка, который её не поддерживает.
Список целевых языков, поддерживающих формальность, см. в разделе Поддерживаемые языки в Руководстве разработчика Amazon Translate.
Маскировка ненормативной лексики -> (строка)
Вы можете включить настройку маскировки ненормативной лексики, если хотите замаскировать ненормативную лексику и фразы в выходном переводе.
Для маскировки ненормативной лексики Amazon Translate заменяет её строкой гравликс «?$#@$». Эта 5-символьная последовательность используется для каждой ненормативной фразы или слова, независимо от длины или количества слов.
Amazon Translate не обнаруживает ненормативную лексику на всех поддерживаемых языках. Для языков, не поддерживающих обнаружение ненормативной лексики, см. Неподдерживаемые языки в Руководстве разработчика Amazon Translate.
Если вы указываете несколько целевых языков для задачи, все целевые языки должны поддерживать маскировку ненормативной лексики. Если любой из целевых языков не поддерживает маскировку ненормативной лексики, перевод не замаскирует ненормативную лексику для ни одного целевого языка.
Краткие формы -> (строка)
При включении кратких форм Amazon Translate уменьшает длину выходного перевода для большинства переводов (по сравнению с тем же переводом без включения краткой формы). По умолчанию краткие формы отключены.
Если вы включаете краткие формы для запроса перевода с недопустимой языковой парой, перевод выполняется с отключённой настройкой краткой формы.
Для языковых пар, которые поддерживают краткие формы, см. Использование кратких форм в Руководстве разработчика Amazon Translate.
Краткая запись:
Formality=string,Profanity=string,Brevity=string
Синтаксис JSON:
{
"Formality": "FORMAL"|"INFORMAL",
"Profanity": "MASK",
"Brevity": "ON"
}
--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 (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.
Вывод
JobId -> (string)
JobStatus -> (string)
Статус задания. Возможные значения включают:
-
SUBMITTED- Задание принято и находится в очереди на обработку. -
IN_PROGRESS- Amazon Translate обрабатывает задание. -
COMPLETED- Задание успешно выполнено, и вывод доступен. -
COMPLETED_WITH_ERROR- Задание выполнено с ошибками. Ошибки можно проанализировать в выводе задания. -
FAILED- Задание не было завершено. Для получения подробностей используйте операцию DescribeTextTranslationJob. -
STOP_REQUESTED- Пользователь, который начал задание, запросил его остановку. -
STOPPED- Задание остановлено.
© Copyright 2025, Amazon Web Services. Created using Sphinx.