Spec-Zone.ru › AWS CLI v2

[ aws . stepfunctions ]

get-execution-history

Описание

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

Если возвращается nextToken, доступны дополнительные результаты. Значение nextToken — уникальный маркер постраничной навигации для каждой страницы. Повторите вызов, используя возвращённый маркер, чтобы получить следующую страницу. Все другие аргументы остаются неизменными. Каждый маркер постраничной навигации действует 24 часа. Использование истекшего маркера вернёт ошибку HTTP 400 InvalidToken.

Это действие API не поддерживается EXPRESS state machines.

См. также: AWS API Documentation

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

Синтаксис

  get-execution-history
--execution-arn <value>
[--reverse-order | --no-reverse-order]
[--include-execution-data | --no-include-execution-data]
[--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]

Параметры

--execution-arn (строка)

Amazon Resource Name (ARN) выполнения.

--reverse-order | --no-reverse-order (логическое значение)

Отображает события в порядке убывания их timeStamp.

--include-execution-data | --no-include-execution-data (логическое значение)

Вы можете указать, возвращать ли данные выполнения (ввод или вывод события истории). По умолчанию — true.

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

Вывод

events -> (список)

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

(структура)

Содержит подробности о событиях выполнения.

timestamp -> (timestamp)

Дата и время события.

type -> (string)

Тип события.

id -> (long)

Идентификатор события. События нумеруются последовательно, начиная с единицы.

previousEventId -> (long)

Идентификатор предыдущего события.

activityFailedEventDetails -> (structure)

Содержит подробности о задаче, которая завершилась сбоем во время выполнения.

error -> (string)

Код ошибки сбоя.

cause -> (string)

Более подробное объяснение причины сбоя.

activityScheduleFailedEventDetails -> (structure)

Содержит подробности о событии планирования задачи, которое завершилось сбоем во время выполнения.

error -> (string)

Код ошибки сбоя.

cause -> (string)

Более подробное объяснение причины сбоя.

activityScheduledEventDetails -> (structure)

Содержит подробности о запланированной задаче во время выполнения.

resource -> (string)

Amazon Resource Name (ARN) запланированной задачи.

input -> (string)

JSON-данные, входные для задачи. Применяются ограничения на размер полезной нагрузки, выражаемые в байтах в кодировке UTF-8.

inputDetails -> (structure)

Содержит подробности о входных данных для события истории выполнения.

truncated -> (boolean)

Указывает, был ли вход или выход усечён в ответе. Всегда false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.

timeoutInSeconds -> (long)

Максимально допустимое время выполнения задачи.

heartbeatInSeconds -> (long)

Максимально допустимое время между двумя сокращениями пульса для задачи.

activityStartedEventDetails -> (structure)

Содержит подробности о начале задачи во время выполнения.

workerName -> (string)

Имя исполнителя, которому назначена задача. Эти имена предоставляются исполнителями при вызове GetActivityTask.

activitySucceededEventDetails -> (structure)

Содержит подробности об успешно завершённой задаче во время выполнения.

output -> (string)

JSON-данные, выходные для задачи. Применяются ограничения на размер полезной нагрузки, выражаемые в байтах в кодировке UTF-8.

outputDetails -> (structure)

Содержит подробности о выходе события истории выполнения.

truncated -> (boolean)

Указывает, был ли вход или выход усечён в ответе. Всегда false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.

activityTimedOutEventDetails -> (structure)

Содержит подробности о таймауте задачи во время выполнения.

error -> (string)

Код ошибки сбоя.

cause -> (string)

Более подробное объяснение причины таймаута.

taskFailedEventDetails -> (structure)

Содержит подробности о сбое задачи.

resourceType -> (string)

Имя сервиса ресурса в состоянии задачи.

resource -> (string)

Действие ресурса, вызываемого состоянием задачи.

error -> (string)

Код ошибки сбоя.

cause -> (string)

Более подробное объяснение причины сбоя.

taskScheduledEventDetails -> (structure)

Содержит подробности о запланированной задаче.

resourceType -> (string)

Имя сервиса ресурса в состоянии задачи.

resource -> (string)

Действие ресурса, вызываемого состоянием задачи.

region -> (string)

Регион запланированной задачи

parameters -> (string)

JSON-данные, передаваемые ресурсу, указанному в состоянии задачи. Применяются ограничения на размер полезной нагрузки, выражаемые в байтах в кодировке UTF-8.

timeoutInSeconds -> (long)

Максимально допустимое время выполнения задачи.

heartbeatInSeconds -> (long)

Максимально допустимое время между двумя сокращениями пульса для задачи.

taskCredentials -> (structure)

Удостоверения, которые Step Functions использует для задачи.

roleArn -> (string)

ARN роли IAM, которую Step Functions предполагает для задачи. Роль может разрешать доступ к ресурсам в других учётных записях.

taskStartFailedEventDetails -> (structure)

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

resourceType -> (string)

Имя сервиса ресурса в состоянии задачи.

resource -> (string)

Действие ресурса, вызываемого состоянием задачи.

error -> (string)

Код ошибки сбоя.

cause -> (string)

Более подробное объяснение причины сбоя.

taskStartedEventDetails -> (structure)

Содержит подробности о запуске задачи.

resourceType -> (string)

Имя сервиса ресурса в состоянии задачи.

resource -> (string)

Действие ресурса, вызываемого состоянием задачи.

taskSubmitFailedEventDetails -> (structure)

Содержит подробности о задаче, где произошел сбой при отправке.

resourceType -> (string)

Имя сервиса ресурса в состоянии задачи.

resource -> (string)

Действие ресурса, вызываемого состоянием задачи.

error -> (string)

Код ошибки сбоя.

cause -> (string)

Более подробное объяснение причины сбоя.

taskSubmittedEventDetails -> (structure)

Содержит подробности о задаче, отправленной на выполнение.

resourceType -> (string)

Имя сервиса ресурса в состоянии задачи.

resource -> (string)

Действие ресурса, вызываемого состоянием задачи.

output -> (string)

Ответ от ресурса, когда задача выполняется. Применяются ограничения на размер полезной нагрузки, выражаемые в байтах в кодировке UTF-8.

outputDetails -> (structure)

Содержит подробности о выходе события истории выполнения.

truncated -> (boolean)

Указывает, был ли вход или выход усечён в ответе. Всегда false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.

taskSucceededEventDetails -> (structure)

Содержит подробности об успешном выполнении задачи.

resourceType -> (string)

Имя сервиса ресурса в состоянии задачи.

resource -> (string)

Действие ресурса, вызываемого состоянием задачи.

output -> (string)

Полный JSON-ответ от ресурса, когда задача выполнена успешно. Этот ответ становится выходом связанной задачи. Применяются ограничения на размер полезной нагрузки, выражаемые в байтах в кодировке UTF-8.

outputDetails -> (structure)

Содержит подробности о выходе события истории выполнения.

truncated -> (boolean)

Указывает, был ли вход или выход усечён в ответе. Всегда false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.

taskTimedOutEventDetails -> (structure)

Содержит подробности о таймауте задачи.

resourceType -> (string)

Имя сервиса ресурса в состоянии задачи.

resource -> (string)

Действие ресурса, вызываемого состоянием задачи.

error -> (string)

Код ошибки сбоя.

cause -> (string)

Более подробное объяснение причины сбоя.

executionFailedEventDetails -> (structure)

Содержит подробности о событии сбоя выполнения.

error -> (string)

Код ошибки сбоя.

cause -> (string)

Более подробное объяснение причины сбоя.

executionStartedEventDetails -> (structure)

Содержит подробности о начале выполнения.

input -> (string)

JSON-данные, входные для выполнения. Применяются ограничения на размер полезной нагрузки, выражаемые в байтах в кодировке UTF-8.

inputDetails -> (structure)

Содержит подробности о входных данных для события истории выполнения.

truncated -> (boolean)

Указывает, был ли вход или выход усечён в ответе. Всегда false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.

roleArn -> (string)

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

stateMachineAliasArn -> (string)

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

stateMachineVersionArn -> (string)

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

executionSucceededEventDetails -> (structure)

Содержит подробности об успешном завершении выполнения.

output -> (string)

JSON-данные, выходные для выполнения. Применяются ограничения на размер полезной нагрузки, выражаемые в байтах в кодировке UTF-8.

outputDetails -> (structure)

Содержит подробности о выходе события истории выполнения.

truncated -> (boolean)

Указывает, был ли вход или выход усечён в ответе. Всегда false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.

executionAbortedEventDetails -> (structure)

Содержит подробности об отмене выполнения.

error -> (string)

Код ошибки сбоя.

cause -> (string)

Более подробное объяснение причины сбоя.

executionTimedOutEventDetails -> (structure)

Содержит подробности о таймауте выполнения.

error -> (string)

Код ошибки сбоя.

cause -> (string)

Более подробное объяснение причины таймаута.

executionRedrivenEventDetails -> (structure)

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

redriveCount -> (integer)

Количество попыток повторного запуска выполнения. Если выполнение ещё не переиздано, redriveCount равно 0. Этот счётчик не обновляется для повторных запусков, которые не смогли начаться или находятся в ожидании повторного запуска.

mapStateStartedEventDetails -> (structure)

Содержит подробности о начатом состоянии Map.

length -> (integer)

Размер массива для итераций состояния Map.

mapIterationStartedEventDetails -> (structure)

Содержит подробности об итерации состояния Map, которая была начата.

name -> (строка)

Имя родительского состояния Map итерации.

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

Индекс массива, принадлежащего итерации состояния Map.

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

Содержит подробности об итерации состояния Map, которая завершилась успешно.

name -> (строка)

Имя родительского состояния Map итерации.

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

Индекс массива, принадлежащего итерации состояния Map.

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

Содержит подробности об итерации состояния Map, которая завершилась неудачно.

name -> (строка)

Имя родительского состояния Map итерации.

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

Индекс массива, принадлежащего итерации состояния Map.

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

Содержит подробности об итерации состояния Map, которая была прервана.

name -> (строка)

Имя родительского состояния Map итерации.

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

Индекс массива, принадлежащего итерации состояния Map.

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

Содержит подробности о Lambda-функции, которая завершилась неудачно во время выполнения.

error -> (строка)

Код ошибки сбоя.

cause -> (строка)

Более подробное описание причины сбоя.

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

Содержит подробности о неудачном планировании Lambda-функции, которое произошло во время выполнения.

error -> (строка)

Код ошибки сбоя.

cause -> (строка)

Более подробное описание причины сбоя.

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

Содержит подробности о запланированной Lambda-функции во время выполнения.

resource -> (строка)

Amazon Resource Name (ARN) запланированной Lambda-функции.

input -> (строка)

JSON-данные, вводимые в Lambda-функцию. На размер полезной нагрузки накладываются ограничения, выраженные в байтах в кодировке UTF-8.

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

Содержит подробности о вводе для события истории выполнения.

truncated -> (логическое значение)

Указывает, был ли входной или выходной данные усечён в ответе. Всегда false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.

timeoutInSeconds -> (длинное целое число)

Максимально допустимая продолжительность работы Lambda-функции.

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

Удостоверения, которые Step Functions использует для задачи.

roleArn -> (строка)

ARN роли IAM, которую Step Functions принимает для задачи. Роль может разрешать доступ к ресурсам между учётными записями.

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

Содержит подробности о Lambda-функции, которая не смогла запуститься во время выполнения.

error -> (строка)

Код ошибки сбоя.

cause -> (строка)

Более подробное описание причины сбоя.

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

Содержит подробности о Lambda-функции, которая успешно завершилась во время выполнения.

output -> (строка)

JSON-данные, выводимые Lambda-функцией. На размер полезной нагрузки накладываются ограничения, выраженные в байтах в кодировке UTF-8.

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

Содержит подробности о выводе события истории выполнения.

truncated -> (логическое значение)

Указывает, был ли входной или выходной данные усечён в ответе. Всегда false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.

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

Содержит подробности о таймауте Lambda-функции, который произошел во время выполнения.

error -> (строка)

Код ошибки сбоя.

cause -> (строка)

Более подробное объяснение причины таймаута.

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

Содержит подробности о состоянии, в которое вошли во время выполнения.

name -> (строка)

Имя состояния.

input -> (строка)

Строка, содержащая JSON-данные ввода для состояния. На размер полезной нагрузки накладываются ограничения, выраженные в байтах в кодировке UTF-8.

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

Содержит подробности об вводе для события истории выполнения.

truncated -> (логическое значение)

Указывает, был ли входной или выходной данные усечён в ответе. Всегда false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.

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

Содержит подробности о выходе из состояния во время выполнения.

name -> (строка)

Имя состояния.

Имя не должно содержать:

  • пробелы
  • скобки < > { } [ ]
  • символы подстановки ? *
  • специальные символы " # % \ ^ | ~ ` $ & , ; : /
  • управляющие символы (U+0000-001F , U+007F-009F )

Для включения ведения журнала с помощью CloudWatch Logs, имя должно содержать только 0-9, A-Z, a-z, -, и _.

output -> (строка)

JSON-данные вывода состояния. На размер полезной нагрузки накладываются ограничения, выраженные в байтах в кодировке UTF-8.

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

Содержит подробности о выводе события истории выполнения.

truncated -> (логическое значение)

Указывает, был ли входной или выходной данные усечён в ответе. Всегда false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.

assignedVariables -> (карта)

Карта имени переменной и значения в виде сериализованного JSON-представления.

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

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

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

Предоставляет подробности о вводе или выводе в событии истории выполнения.

truncated -> (логическое значение)

Указывает, были ли назначенные переменные усечены в ответе. Всегда false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.

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

Содержит подробности, такие как mapRunArn, и дату и время начала Map Run. mapRunArn — это Amazon Resource Name (ARN) Map Run, который был запущен.

mapRunArn -> (строка)

Amazon Resource Name (ARN) запущенного Map Run.

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

Содержит подробности об ошибке и причине сбоя Map Run.

error -> (строка)

Код ошибки сбоя Map Run.

cause -> (строка)

Более подробное объяснение причины сбоя.

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

Содержит подробности о попытке перезапуска Map Run.

mapRunArn -> (строка)

Amazon Resource Name (ARN) Map Run, который был перезапущен.

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

Количество раз, когда Map Run был перезапущен на данном этапе истории выполнения, включая это событие. Счётчик перезапусков для перезапущенного Map Run всегда больше 0.

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

Содержит подробности об ошибке оценки, которая произошла при обработке состояния.

error -> (строка)

Код ошибки сбоя.

cause -> (строка)

Более подробное описание причины сбоя.

location -> (строка)

Расположение поля в состоянии, где произошла ошибка оценки.

state -> (строка)

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

nextToken -> (строка)

Если возвращается nextToken, то есть больше результатов. Значение nextToken — это уникальный маркер постраничной навигации для каждой страницы. Повторите вызов, используя возвращённый маркер, чтобы получить следующую страницу. Не изменяйте другие аргументы. Каждый маркер постраничной навигации истекает через 24 часа. Использование истекшего маркера постраничной навигации вернёт ошибку HTTP 400 InvalidToken.

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

Spec-Zone.ru

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