Spec-Zone.ru › AWS CLI v2

[ aws . transcribe ]

list-transcription-jobs

Описание

Предоставляет список транскрипционных заданий, соответствующих заданным критериям. Если критерии не указаны, возвращаются все транскрипционные задания.

Чтобы получить подробную информацию о конкретном транскрипционном задании, используйте операцию.

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

Синтаксис

  list-transcription-jobs
[--status <value>]
[--job-name-contains <value>]
[--next-token <value>]
[--max-results <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]

Параметры

--status (строка)

Возвращает только транскрипционные задания со указанным статусом. Задания упорядочены по дате создания, начиная с самого нового. Если вы не включите Status, возвращаются все транскрипционные задания.

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

  • QUEUED
  • IN_PROGRESS
  • FAILED
  • COMPLETED

--job-name-contains (строка)

Возвращает только транскрипционные задания, содержащие указанную строку. Поиск нечувствителен к регистру.

--next-token (строка)

Если ваш запрос ListTranscriptionJobs возвращает больше результатов, чем можно отобразить, NextToken отображается в ответе вместе со связанной строкой. Чтобы получить следующую страницу результатов, скопируйте эту строку и повторите свой запрос, включив NextToken со значением скопированной строки. Повторяйте по мере необходимости, чтобы просмотреть все результаты.

--max-results (целое число)

Максимальное количество транскрипционных заданий, возвращаемых на каждой странице результатов. Если результатов меньше, чем указанное вами значение, возвращаются только фактические результаты. Если вы не укажете значение, по умолчанию используется 5.

--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 в Руководстве пользователя AWS CLI.

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

Для просмотра списка транскрипционных заданий

В следующем примере list-transcription-jobs выводится список транскрипционных заданий, связанных с вашей учетной записью AWS и регионом.

aws transcribe list-transcription-jobs

Вывод:

{
    "NextToken": "NextToken",
    "TranscriptionJobSummaries": [
        {
            "TranscriptionJobName": "speak-id-job-1",
            "CreationTime": "2020-08-17T21:06:15.391000+00:00",
            "StartTime": "2020-08-17T21:06:15.416000+00:00",
            "CompletionTime": "2020-08-17T21:07:05.098000+00:00",
            "LanguageCode": "language-code",
            "TranscriptionJobStatus": "COMPLETED",
            "OutputLocationType": "SERVICE_BUCKET"
        },
        {
            "TranscriptionJobName": "job-1",
            "CreationTime": "2020-08-17T20:50:24.207000+00:00",
            "StartTime": "2020-08-17T20:50:24.230000+00:00",
            "CompletionTime": "2020-08-17T20:52:18.737000+00:00",
            "LanguageCode": "language-code",
            "TranscriptionJobStatus": "COMPLETED",
            "OutputLocationType": "SERVICE_BUCKET"
        },
        {
            "TranscriptionJobName": "sdk-test-job-4",
            "CreationTime": "2020-08-17T20:32:27.917000+00:00",
            "StartTime": "2020-08-17T20:32:27.956000+00:00",
            "CompletionTime": "2020-08-17T20:33:15.126000+00:00",
            "LanguageCode": "language-code",
            "TranscriptionJobStatus": "COMPLETED",
            "OutputLocationType": "SERVICE_BUCKET"
        },
        {
            "TranscriptionJobName": "Diarization-speak-id",
            "CreationTime": "2020-08-10T22:10:09.066000+00:00",
            "StartTime": "2020-08-10T22:10:09.116000+00:00",
            "CompletionTime": "2020-08-10T22:26:48.172000+00:00",
            "LanguageCode": "language-code",
            "TranscriptionJobStatus": "COMPLETED",
            "OutputLocationType": "SERVICE_BUCKET"
        },
        {
            "TranscriptionJobName": "your-transcription-job-name",
            "CreationTime": "2020-07-29T17:45:09.791000+00:00",
            "StartTime": "2020-07-29T17:45:09.826000+00:00",
            "CompletionTime": "2020-07-29T17:46:20.831000+00:00",
            "LanguageCode": "language-code",
            "TranscriptionJobStatus": "COMPLETED",
            "OutputLocationType": "SERVICE_BUCKET"
        }
    ]
}

Дополнительную информацию см. в разделе Начало работы (AWS Command Line Interface) в Руководстве разработчика Amazon Transcribe.

Вывод

Статус -> (строка)

Отображает все задания транскрипции, у которых статус соответствует заданному в запросе. Задания упорядочены по дате создания, при этом новое задание находится в начале.

NextToken -> (строка)

Если NextToken присутствует в ответе, это означает, что не все результаты отображены. Чтобы просмотреть следующий набор результатов, скопируйте строку, связанную с параметром NextToken в выводе результатов, затем выполните запрос еще раз, включив NextToken со значением скопированной строки. Повторяйте, если необходимо, чтобы просмотреть все результаты.

TranscriptionJobSummaries -> (список)

Предоставляет сводку информации о каждом результате.

(структура)

Предоставляет подробную информацию об определённом задании транскрипции.

TranscriptionJobName -> (строка)

Имя задания транскрипции. Имена заданий чувствительны к регистру и должны быть уникальными в рамках учётной записи Amazon Web Services.

CreationTime -> (метка времени)

Дата и время создания запроса на указанное задание транскрипции.

Метки времени имеют формат YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC . Например, 2022-05-04T12:32:58.761000-07:00 представляет задание транскрипции, которое начало обработку в 12:32 пополудни по UTC-7 4 мая 2022 года.

StartTime -> (метка времени)

Дата и время начала обработки вашего задания транскрипции.

Метки времени имеют формат YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC . Например, 2022-05-04T12:32:58.789000-07:00 представляет задание транскрипции, которое начало обработку в 12:32 пополудни по UTC-7 4 мая 2022 года.

CompletionTime -> (метка времени)

Дата и время завершения обработки указанного задания транскрипции.

Метки времени имеют формат YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC . Например, 2022-05-04T12:33:13.922000-07:00 представляет задание транскрипции, которое завершило обработку в 12:33 пополудни по UTC-7 4 мая 2022 года.

LanguageCode -> (строка)

Код языка, используемый для создания транскрипции.

TranscriptionJobStatus -> (строка)

Предоставляет статус вашего задания транскрипции.

Если статус COMPLETED, задание завершено, и результаты можно найти по адресу, указанному в TranscriptFileUri (или RedactedTranscriptFileUri, если вы запросили удаление текста из транскрипта). Если статус FAILED, FailureReason содержит подробности о причинах сбоя задания транскрипции.

FailureReason -> (строка)

Если TranscriptionJobStatus имеет значение FAILED, FailureReason содержит информацию о причине сбоя задания транскрипции. См. также: Распространённые ошибки.

OutputLocationType -> (строка)

Указывает, где хранится указанный выходной результат транскрипции.

Если значение CUSTOMER_BUCKET, местоположение — это указанный вами в запросе Amazon S3 bucket с помощью параметра OutputBucketName. Если вы также включили OutputKey в свой запрос, ваш выходной результат находится по пути, указанному в запросе.

Если значение SERVICE_BUCKET, местоположение — это управляемый сервисом Amazon S3 bucket. Чтобы получить доступ к транскрипту, хранящемуся в управляемом сервисом bucket, используйте URI, указанный в поле TranscriptFileUri или RedactedTranscriptFileUri.

ContentRedaction -> (структура)

Настройки удаления контента для задания транскрипции.

RedactionType -> (строка)

Укажите категорию информации, которую вы хотите удалить; PII (персонально идентифицируемая информация) — единственное допустимое значение. Вы можете использовать PiiEntityTypes, чтобы выбрать типы ПИИ, которые вы хотите удалить. Если вы не включаете PiiEntityTypes в свой запрос, вся ПИИ удаляется.

RedactionOutput -> (строка)

Укажите, хотите ли вы только отредактированный транскрипт или отредактированный и неотредактированный транскрипт.

При выборе redacted Amazon Transcribe создаёт только отредактированный транскрипт.

При выборе redacted_and_unredacted Amazon Transcribe создаёт отредактированный и неотредактированный транскрипт (в виде двух отдельных файлов).

PiiEntityTypes -> (список)

Укажите типы персонально идентифицируемой информации (ПИИ), которые вы хотите удалить из своего транскрипта. Вы можете включить любое количество типов или выбрать ALL. Если вы не включаете PiiEntityTypes в свой запрос, вся ПИИ удаляется.

(строка)

ModelSettings -> (структура)

Предоставляет имя настраиваемой языковой модели, которая была включена в указанное задание транскрипции.

Используйте ModelSettings с подпараметром LanguageModelName только если вы не используете автоматическое определение языка (). Если в вашем запросе используется LanguageIdSettings, этот параметр содержит подпараметр LanguageModelName.

LanguageModelName -> (строка)

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

Язык указанной настраиваемой языковой модели должен соответствовать коду языка, который вы указываете в запросе транскрипции. Если языки не совпадают, настраиваемая языковая модель не применяется. Несоответствие языков не приводит к ошибкам или предупреждениям.

IdentifyLanguage -> (булево)

Указывает, был ли включён автоматический анализ языка (TRUE) для указанного задания транскрипции.

IdentifyMultipleLanguages -> (булево)

Указывает, был ли включён автоматический анализ нескольких языков (TRUE) для указанного задания транскрипции.

IdentifiedLanguageScore -> (число с плавающей точкой)

Оценка уверенности, связанная с языком, определённым в вашем медиафайле.

Оценки уверенности имеют значения от 0 до 1; более высокое значение указывает на большую вероятность того, что определённый язык соответствует языку, на котором произносилось содержание медиафайла.

LanguageCodes -> (список)

Коды языков, используемые для создания задания транскрипции. Этот параметр используется при определении нескольких языков. Для определения одного языка присутствует одиночная версия этого параметра, LanguageCode.

(структура)

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

LanguageCode -> (строка)

Предоставляет код языка для каждого языка, определённого в медиафайле.

DurationInSeconds -> (число с плавающей точкой)

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

ToxicityDetection -> (список)

Указывает, был ли включён анализ токсичности для указанного задания транскрипции.

(структура)

Содержит ToxicityCategories, который является обязательным параметром, если вы хотите включить анализ токсичности (ToxicityDetection) в свой запрос транскрипции.

ToxicityCategories -> (список)

Если вы включаете ToxicityDetection в свой запрос транскрипции, вы также должны включить ToxicityCategories. Единственное допустимое значение для этого параметра — ALL.

(строка)

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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