get-workflow-runs
Описание
Получает метаданные для всех запусков заданного рабочего процесса.
См. также: Документация AWS API
get-workflow-runs является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничную обработку, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной обработкой аргумент --query должен извлекать данные из результатов следующих выражений запроса: Runs
Синтаксис
get-workflow-runs
--name <value>
[--include-graph | --no-include-graph]
[--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 (строка)
--include-graph | --no-include-graph (логическое значение)
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON следует формату, заданному --generate-cli-skeleton. Если на командной строке заданы другие аргументы, эти значения переопределяют значения, указанные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, заданного в JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Токен для указания места начала постраничной обработки. Это NextToken из ранее усеченного ответа.
Примеры использования см. в разделе «Постраничная обработка» в руководстве пользователя AWS CLI.
--page-size (целое число)
Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.
Примеры использования см. в разделе «Постраничная обработка» в руководстве пользователя AWS CLI.
--max-items (целое число)
Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для возобновления постраничной обработки укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе «Постраничная обработка» в руководстве пользователя AWS CLI.
--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
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для использования при фильтрации данных ответа.
--profile (строка)
Использование определенного профиля из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отображает версию этого инструмента.
--color (строка)
Включает/отключает цветной вывод.
- вкл
- выкл
- авто
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.
--ca-bundle (строка)
Файл сертификатов CA для использования при проверке сертификатов SSL. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 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.
Вывод
Запуски -> (список)
Список объектов метаданных запусков рабочих процессов.
(структура)
Запуск рабочего процесса — это выполнение рабочего процесса, предоставляющее всю информацию о выполнении.
Имя -> (строка)
WorkflowRunId -> (строка)
PreviousRunId -> (строка)
WorkflowRunProperties -> (карта)
Свойства запуска рабочего процесса, которые были установлены во время запуска.
ключ -> (строка)
значение -> (строка)
StartedOn -> (метка времени)
CompletedOn -> (метка времени)
Статус -> (строка)
ErrorMessage -> (строка)
foo».Статистика -> (структура)
Статистика запуска.
TotalActions -> (целое число)
TimeoutActions -> (целое число)
FailedActions -> (целое число)
StoppedActions -> (целое число)
SucceededActions -> (целое число)
RunningActions -> (целое число)
ErroredActions -> (целое число)
WaitingActions -> (целое число)
График -> (структура)
Граф, представляющий все компоненты Glue, относящиеся к рабочему процессу, в виде узлов и направленных связей между ними в виде ребер.
Узлы -> (список)
Список компонентов Glue, относящихся к рабочему процессу, представленных в виде узлов.
(структура)
Узел представляет собой компонент Glue (триггер, обозреватель или задачу) на графике рабочего процесса.
Тип -> (строка)
Имя -> (строка)
UniqueId -> (строка)
TriggerDetails -> (структура)
Подробности триггера, когда узел представляет триггер.
Триггер -> (структура)
Информация о триггере, представленном узлом триггера.
Имя -> (строка)
ИмяРабочегоПроцесса -> (строка)
Идентификатор -> (строка)
Тип -> (строка)
Состояние -> (строка)
Описание -> (строка)
Расписание -> (строка)
cron, используемое для указания расписания (см. Расписания по времени для задач и обозревателей. Например, чтобы запускать что-то каждый день в 12:15 по UTC, вы бы указали: cron(15 12 * * ? *) .Действия -> (список)
Действия, инициированные этим триггером.
(структура)
Определяет действие, которое должно быть инициировано триггером.
ИмяЗадачи -> (строка)
Аргументы -> (карта)
Аргументы задачи, используемые при срабатывании этого триггера. Для этого запуска задачи они заменяют значения аргументов по умолчанию, заданных в определении задачи.
Вы можете указать здесь аргументы, которые будет потреблять ваша собственная сценарий выполнения задачи, а также аргументы, потребляемые самим Glue.
Дополнительную информацию о том, как указать и использовать собственные аргументы задач, см. в разделе «Вызов API Glue на Python» в руководстве разработчика.
Дополнительную информацию о парах «ключ-значение», которые потребляет Glue для настройки вашей задачи, см. в разделе «Специальные параметры, используемые Glue» в руководстве разработчика.
ключ -> (строка)
значение -> (строка)
Время ожидания -> (целое число)
Время ожидания JobRun в минутах. Это максимальное время, которое запуск задачи может использовать ресурсы, прежде чем он будет завершен и перейдет в состояние TIMEOUT. Это переопределяет значение таймаута, заданное в родительской задаче.
Задачи должны иметь значения таймаута менее 7 дней или 10080 минут. В противном случае задачи выдадут исключение.
Если значение опущено, таймаут по умолчанию составляет 2880 минут.
Все существующие задачи Glue, имеющие значение таймаута больше 7 дней, будут изменены на 7 дней. Например, если вы указали таймаут в 20 дней для пакетной задачи, она будет остановлена на 7-й день.
Для потоковых задач, если вы настроили окно обслуживания, оно будет перезапущено во время окна обслуживания через 7 дней.
SecurityConfiguration -> (строка)
SecurityConfiguration, которая будет использоваться с этим действием.NotificationProperty -> (структура)
Указывает конфигурационные свойства уведомления о запуске задачи.
NotifyDelayAfter -> (целое число)
CrawlerName -> (строка)
Условие -> (структура)
Условие этого триггера, определяющее, когда он сработает.
Логическое -> (строка)
Условие -> (список)
Список условий, определяющих, когда будет срабатывать триггер.
(структура)
Определяет условие, при котором срабатывает триггер.
ЛогическийОператор -> (строка)
ИмяЗадачи -> (строка)
Состояние -> (строка)
SUCCEEDED , STOPPED , FAILED и TIMEOUT. Единственные состояния обозревателей, на которые может реагировать триггер, — это SUCCEEDED , FAILED и CANCELLED.CrawlerName -> (строка)
CrawlState -> (строка)
EventBatchingCondition -> (структура)
Условие пакетной обработки, которое должно быть выполнено (указано количество полученных событий или истекло окно времени пакетной обработки) перед срабатыванием триггера события EventBridge.
РазмерПакета -> (целое число)
ВремяПакета -> (целое число)
JobDetails -> (структура)
Подробности задачи, когда узел представляет собой задачу.
ЗапускаЗадачи -> (список)
Информация о запусках задач, представленных узлом задачи.
(структура)
Содержит информацию о выполнении задания.
Id -> (строка)
Attempt -> (целое число)
PreviousRunId -> (строка)
JobRunId, указанный в действии StartJobRun.TriggerName -> (строка)
JobName -> (строка)
JobMode -> (строка)
Режим, описывающий способ создания задания. Допустимые значения:
-
SCRIPT- Задание создано с помощью редактора сценариев Glue Studio. -
VISUAL- Задание создано с помощью визуального редактора Glue Studio. -
NOTEBOOK- Задание создано с помощью ноутбука интерактивных сессий.
Если поле JobMode отсутствует или имеет значение null, по умолчанию используется значение SCRIPT.
JobRunQueuingEnabled -> (логическое значение)
Указывает, включена ли очередь выполнения заданий для этого выполнения задания.
Значение true означает, что очередь выполнения заданий включена для данного выполнения. Если значение false или оно не указано, выполнение задания не будет учитываться для очереди.
StartedOn -> (метка времени)
LastModifiedOn -> (метка времени)
CompletedOn -> (метка времени)
JobRunState -> (строка)
Arguments -> (карта)
Аргументы задания, связанные с этим выполнением. Для этого выполнения задания они заменяют аргументы по умолчанию, установленные в определении задания.
Вы можете указать здесь аргументы, используемые собственным скриптом выполнения задания, а также аргументы, используемые самим Glue.
Аргументы задания могут регистрироваться. Не передавайте открытые секреты в качестве аргументов. Извлекайте секреты из соединения Glue, Secrets Manager или другого механизма управления секретами, если вы хотите хранить их в задании.
Дополнительную информацию о том, как указать и использовать собственные аргументы задания, см. в разделе Вызов API Glue на Python в руководстве разработчика.
Дополнительную информацию об аргументах, которые можно указать в этом поле при настройке заданий Spark, см. в разделе Специальные параметры, используемые Glue, в руководстве разработчика.
Дополнительную информацию об аргументах, которые можно указать в этом поле при настройке заданий Ray, см. в разделе Использование параметров задания в заданиях Ray в руководстве разработчика.
key -> (строка)
value -> (строка)
ErrorMessage -> (строка)
PredecessorRuns -> (список)
Список предшественников этого выполнения задания.
(структура)
Выполнение задания, которое использовалось в предикате условного триггера, который запустил это выполнение задания.
JobName -> (строка)
RunId -> (строка)
AllocatedCapacity -> (целое число)
Это поле устарело. Используйте MaxCapacity вместо него.
Количество единиц обработки данных Glue (DPU), выделенных для этого JobRun. Можно выделить от 2 до 100 DPU; по умолчанию используется 10. DPU — это относительная мера вычислительной мощности, состоящая из 4 vCPU вычислительной мощности и 16 ГБ памяти. Дополнительную информацию см. на странице ценообразования Glue.
ExecutionTime -> (целое число)
Timeout -> (целое число)
Таймаут JobRun в минутах. Это максимальное время, в течение которого выполнение задания может использовать ресурсы, прежде чем оно будет завершено и перейдет в состояние TIMEOUT. Это значение переопределяет значение таймаута, установленное в родительском задании.
Значения таймаута заданий должны быть меньше 7 дней или 10080 минут. В противном случае задания выдадут исключение.
Если значение не указано, по умолчанию используется 2880 минут.
Все существующие задания Glue, у которых значение таймаута превышало 7 дней, будут установлено по умолчанию в 7 дней. Например, если для задания пакетной обработки вы указали таймаут в 20 дней, оно будет остановлено на 7-й день.
Для потоковых заданий, если у вас настроен интервал технического обслуживания, он будет перезапущен в течение интервала технического обслуживания после 7 дней.
MaxCapacity -> (двойное)
Для заданий Glue версии 1.0 или более ранних, использующих стандартный тип рабочего узла, количество единиц обработки данных Glue (DPU), которые могут быть выделены при запуске этого задания. DPU — это относительная мера вычислительной мощности, состоящая из 4 vCPU вычислительной мощности и 16 ГБ памяти. Дополнительную информацию см. на странице ценообразования Glue.
Для заданий Glue версии 2.0 и выше вы не можете указать Maximum capacity. Вместо этого вы должны указать Worker type и Number of workers.
Не устанавливайте MaxCapacity, если используете WorkerType и NumberOfWorkers.
Значение, которое можно выделить для MaxCapacity, зависит от того, запускаете ли вы задание Python shell, задание Apache Spark ETL или задание Apache Spark потоковой обработки ETL:
- При указании задания Python shell (
JobCommand.Name=”pythonshell”) можно выделить либо 0,0625, либо 1 DPU. По умолчанию используется 0,0625 DPU. - При указании задания Apache Spark ETL (
JobCommand.Name=”glueetl”) или задания Apache Spark потоковой обработки ETL (JobCommand.Name=”gluestreaming”) можно выделить от 2 до 100 DPU. По умолчанию используется 10 DPU. Для этого типа задания нельзя использовать дробное выделение DPU.
WorkerType -> (строка)
Тип предопределенного рабочего узла, который выделяется при запуске задания. Принимает значения G.1X, G.2X, G.4X, G.8X или G.025X для заданий Spark. Принимает значение Z.2X для заданий Ray.
- Для типа рабочего узла
G.1Xкаждый рабочий узел соответствует 1 DPU (4 vCPU, 16 ГБ памяти) с диском 94 ГБ и предоставляет 1 executor на рабочий узел. Мы рекомендуем этот тип рабочего узла для рабочих нагрузок, таких как преобразования данных, объединения и запросы, чтобы предложить масштабируемый и экономически эффективный способ запуска большинства заданий. - Для типа рабочего узла
G.2Xкаждый рабочий узел соответствует 2 DPU (8 vCPU, 32 ГБ памяти) с диском 138 ГБ и предоставляет 1 executor на рабочий узел. Мы рекомендуем этот тип рабочего узла для рабочих нагрузок, таких как преобразования данных, объединения и запросы, чтобы предложить масштабируемый и экономически эффективный способ запуска большинства заданий. - Для типа рабочего узла
G.4Xкаждый рабочий узел соответствует 4 DPU (16 vCPU, 64 ГБ памяти) с диском 256 ГБ и предоставляет 1 executor на рабочий узел. Мы рекомендуем этот тип рабочего узла для заданий, рабочие нагрузки которых содержат наиболее сложные преобразования, агрегации, объединения и запросы. Этот тип рабочего узла доступен только для заданий Spark ETL Glue версии 3.0 и выше в следующих регионах Amazon Web Services: US East (Ohio), US East (N. Virginia), US West (Oregon), Asia Pacific (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Canada (Central), Europe (Frankfurt), Europe (Ireland) и Europe (Stockholm). - Для типа рабочего узла
G.8Xкаждый рабочий узел соответствует 8 DPU (32 vCPU, 128 ГБ памяти) с диском 512 ГБ и предоставляет 1 executor на рабочий узел. Мы рекомендуем этот тип рабочего узла для заданий, рабочие нагрузки которых содержат наиболее сложные преобразования, агрегации, объединения и запросы. Этот тип рабочего узла доступен только для заданий Spark ETL Glue версии 3.0 или выше в тех же регионах Amazon Web Services, что и для типа рабочего узлаG.4X. - Для типа рабочего узла
G.025Xкаждый рабочий узел соответствует 0,25 DPU (2 vCPU, 4 ГБ памяти) с диском 84 ГБ и предоставляет 1 executor на рабочий узел. Мы рекомендуем этот тип рабочего узла для потоковых заданий с низким объемом. Этот тип рабочего узла доступен только для потоковых заданий Glue версии 3.0 или выше. - Для типа рабочего узла
Z.2Xкаждый рабочий узел соответствует 2 M-DPU (8 vCPU, 64 ГБ памяти) с диском 128 ГБ и предоставляет до 8 рабочих узлов Ray на основе автомасштабирования.
NumberOfWorkers -> (целое число)
workerType, которые выделяются при запуске задания.SecurityConfiguration -> (строка)
SecurityConfiguration, которая будет использоваться с этим выполнением задания.LogGroupName -> (строка)
/aws-glue/jobs/, в этом случае шифрование по умолчанию — NONE. Если вы добавите имя роли и имя SecurityConfiguration (то есть /aws-glue/jobs-yourRoleName-yourSecurityConfigurationName/), тогда для шифрования группы журналов будет использоваться эта конфигурация безопасности.NotificationProperty -> (структура)
Указывает свойства конфигурации уведомления о выполнении задания.
NotifyDelayAfter -> (целое число)
GlueVersion -> (строка)
В заданиях Spark, GlueVersion определяет версии Apache Spark и Python, доступные в Glue в задании. Версия Python указывает поддерживаемую версию для заданий типа Spark.
Задания Ray должны установить GlueVersion на 4.0 или выше. Однако версии Ray, Python и дополнительных библиотек, доступных в вашем задании Ray, определяются параметром Runtime команды задания.
Дополнительную информацию о доступных версиях Glue и соответствующих версиях Spark и Python см. в руководстве разработчика в разделе Версия Glue.
Задания, созданные без указания версии Glue, по умолчанию имеют Glue 0.9.
DPUSeconds -> (двойное)
FLEX или при включенном автомасштабировании и представляет общее время работы каждого исполнителя в течение жизненного цикла выполнения задания в секундах, умноженное на коэффициент DPU (1 для G.1X, 2 для G.2X или 0,25 для G.025X рабочих узлов). Это значение может отличаться от executionEngineRuntime * MaxCapacity, как в случае заданий с автомасштабированием, так как количество исполнителей, работающих в данный момент, может быть меньше, чем MaxCapacity. Поэтому возможно, что значение DPUSeconds меньше, чем executionEngineRuntime * MaxCapacity.ExecutionClass -> (строка)
Указывает, выполняется ли задание со стандартным или гибким классом выполнения. Стандартный класс выполнения подходит для задач с ограничением по времени, которые требуют быстрого запуска задания и выделенных ресурсов.
Гибкий класс выполнения подходит для задач, не имеющих ограничений по времени, время запуска и завершения которых может меняться.
Только задания с Glue версии 3.0 и выше и типом команды glueetl будут разрешены для установки ExecutionClass на FLEX. Гибкий класс выполнения доступен для заданий Spark.
MaintenanceWindow -> (строка)
Это поле указывает день недели и час для окна технического обслуживания для задач потоковой обработки. Glue периодически выполняет задачи технического обслуживания. Во время этих окон технического обслуживания Glue потребуется перезапустить ваши задачи потоковой обработки.
Glue перезапустит задачу в течение 3 часов с момента указанного окна технического обслуживания. Например, если вы настроите окно технического обслуживания на понедельник в 10:00 по Гринвичу, ваши задачи будут перезапущены между 10:00 по Гринвичу и 13:00 по Гринвичу.
ProfileName -> (строка)
StateDetail -> (строка)
Это поле содержит подробную информацию, относящуюся к состоянию запуска задачи. Поле может быть пустым.
Например, когда запуск задачи находится в состоянии ОЖИДАНИЯ в результате очереди запусков задач, это поле содержит причину, по которой запуск задачи находится в этом состоянии.
CrawlerDetails -> (структура)
Подробная информация о программе сканирования, если узел представляет собой программу сканирования.
Crawls -> (список)
Список сканирований, представленных узлом сканирования.
(структура)
Подробная информация о сканировании в потоке работ.
State -> (строка)
StartedOn -> (метка времени)
CompletedOn -> (метка времени)
ErrorMessage -> (строка)
LogGroup -> (строка)
LogStream -> (строка)
Edges -> (список)
Список всех направленных соединений между узлами, принадлежащими потоку работ.
(структура)
Ребро представляет собой направленное соединение между двумя компонентами Glue, которые являются частью потока работ, к которому относится ребро.
SourceId -> (строка)
DestinationId -> (строка)
StartingEventBatchCondition -> (структура)
Условие пакетной обработки, которое инициировало запуск потока работ.
BatchSize -> (целое число)
BatchWindow -> (целое число)
NextToken -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.