Spec-Zone.ru › AWS CLI v2

[ aws . databrew ]

list-job-runs

Описание

Выводит все предыдущие выполнения определенного задания DataBrew.

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

list-job-runs является постраничной операцией. Для получения всего набора результатов могут быть сделаны несколько API-запросов. Вы можете отключить постраничность, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответ на постраничный запрос, аргумент --query должен извлечь данные из результатов следующих выражений запросов: JobRuns

Синтаксис

  list-job-runs
--name <value>
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]

Параметры

--name (строка)

Имя задания.

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

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

Маркер для указания, с какой точки начать постраничный вывод. Это NextToken из ранее укороченного ответа.

Примеры использования см. в разделе «Постраничный вывод» в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для запроса в AWS-сервис. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, извлекая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе «Постраничный вывод» в Руководстве пользователя AWS Command Line Interface.

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

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше, чем указанное значение, в выводе команды предоставляется NextToken. Для возобновления постраничного вывода предоставьте значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе «Постраничный вывод» в Руководстве пользователя AWS Command Line Interface.

--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
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

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

--profile (строка)

Использование определенного профиля из файла с вашими учетными данными.

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

--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-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Вывод

JobRuns -> (список)

Список запусков задач, которые произошли для указанной задачи.

(структура)

Представляет один запуск задачи DataBrew.

Attempt -> (целое число)

Количество попыток, предпринятых DataBrew для запуска задачи.

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

Дата и время завершения обработки задачи.

DatasetName -> (строка)

Имя набора данных для обработки задачей.

ErrorMessage -> (строка)

Сообщение об ошибке (если таковая произошла) при выполнении задачи.

ExecutionTime -> (целое число)

Время в секундах, в течение которого запуск задачи потреблял ресурсы.

JobName -> (строка)

Имя задачи, обрабатываемой во время этого запуска.

RunId -> (строка)

Уникальный идентификатор запуска задачи.

State -> (строка)

Текущее состояние сущности запуска задачи.

LogSubscription -> (строка)

Текущий статус ведения журнала Amazon CloudWatch для запуска задачи.

LogGroupName -> (строка)

Имя группы журналов Amazon CloudWatch, куда задача записывает диагностические сообщения при выполнении.

Outputs -> (список)

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

(структура)

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

CompressionFormat -> (строка)

Алгоритм сжатия, используемый для сжатия выходного текста задачи.

Format -> (строка)

Формат данных выходных данных задачи.

PartitionColumns -> (список)

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

(строка)

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

Расположение в Amazon S3, куда задача записывает свои выходные данные.

Bucket -> (строка)

Имя ведра Amazon S3.

Key -> (строка)

Уникальное имя объекта в ведре.

BucketOwner -> (строка)

Идентификатор учетной записи Amazon Web Services владельца ведра.

Overwrite -> (булево)

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

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

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

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

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

Delimiter -> (строка)

Один символ, указывающий разделитель, используемый для создания выходных данных задачи в формате CSV.

MaxOutputFiles -> (целое число)

Максимальное количество файлов, которые должна сгенерировать задача и записать в папку вывода. Для вывода, разделяемого по столбцам, значение MaxOutputFiles является максимальным количеством файлов на разбиение.

DataCatalogOutputs -> (список)

Один или несколько артефактов, представляющих выходные данные Glue Data Catalog при выполнении задачи.

(структура)

Представляет параметры, определяющие, как и куда в Glue Data Catalog DataBrew записывает выходные данные, созданные задачами рецептов.

CatalogId -> (строка)

Уникальный идентификатор учетной записи Amazon Web Services, владеющей Data Catalog, хранящим данные.

DatabaseName -> (строка)

Имя базы данных в Data Catalog.

TableName -> (строка)

Имя таблицы в Data Catalog.

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

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

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

Представляет расположение в Amazon S3 (имя ведра и имя объекта), куда DataBrew может записывать выходные данные из задачи.

Bucket -> (строка)

Имя ведра Amazon S3.

Key -> (строка)

Уникальное имя объекта в ведре.

BucketOwner -> (строка)

Идентификатор учетной записи Amazon Web Services владельца ведра.

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

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

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

Представляет расположение в Amazon S3 (имя ведра и имя объекта), куда DataBrew может хранить промежуточные результаты.

Bucket -> (строка)

Имя ведра Amazon S3.

Key -> (строка)

Уникальное имя объекта в ведре.

BucketOwner -> (строка)

Идентификатор учетной записи Amazon Web Services владельца ведра.

TableName -> (строка)

Префикс имени таблицы, которую DataBrew создаст в базе данных.

Overwrite -> (булево)

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

DatabaseOutputs -> (список)

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

(структура)

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

GlueConnectionName -> (строка)

Подключение Glue, которое хранит информацию о подключении к целевой базе данных.

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

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

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

Представляет расположение в Amazon S3 (имя ведра и имя объекта), куда DataBrew может хранить промежуточные результаты.

Bucket -> (строка)

Имя ведра Amazon S3.

Key -> (строка)

Уникальное имя объекта в ведре.

BucketOwner -> (строка)

Идентификатор учетной записи Amazon Web Services владельца ведра.

TableName -> (строка)

Префикс имени таблицы, которую DataBrew создаст в базе данных.

DatabaseOutputMode -> (строка)

Режим вывода для записи в базу данных. В настоящее время поддерживается вариант: NEW_TABLE.

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

Набор шагов, обработанных задачей.

Name -> (строка)

Имя рецепта.

RecipeVersion -> (строка)

Идентификатор версии рецепта.

StartedBy -> (строка)

Amazon Resource Name (ARN) пользователя, который инициировал запуск задачи.

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

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

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

Конфигурация образца только для задач профилирования, которая определяет количество строк, на которых выполняется задача профилирования. Если значение JobSample не указано, используется значение по умолчанию. Значение по умолчанию — CUSTOM_ROWS для параметра mode и 20 000 для параметра size.

Mode -> (строка)

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

  • FULL_DATASET — Задача профилирования выполняется на всем наборе данных.
  • CUSTOM_ROWS — Задача профилирования выполняется на количестве строк, указанном в параметре Size.

Size -> (длинное целое)

Параметр Size требуется только в случае, если режим равен CUSTOM_ROWS. Задача профилирования выполняется на указанном количестве строк. Максимальное значение для размера — Long.MAX_VALUE.

Long.MAX_VALUE = 9223372036854775807

ValidationConfigurations -> (список)

Список конфигураций валидации, применяемых к запуску задачи профилирования.

(структура)

Конфигурация для проверки качества данных. Используется для выбора наборов правил и режима проверки, которые будут использоваться в задаче профилирования. Когда ValidationConfiguration равно null, задача профилирования выполняется без проверки качества данных.

RulesetArn -> (строка)

Amazon Resource Name (ARN) для набора правил, который должен быть проверен в задаче профилирования. TargetArn выбранного набора правил должен совпадать с Amazon Resource Name (ARN) набора данных, связанного с задачей профилирования.

ValidationMode -> (строка)

Режим проверки качества данных. Режим по умолчанию — «CHECK_ALL», который проверяет все правила, определенные в выбранном наборе правил.

NextToken -> (строка)

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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