[ 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 (строка)
--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)
input -> (string)
inputDetails -> (structure)
Содержит подробности о входных данных для события истории выполнения.
truncated -> (boolean)
false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.timeoutInSeconds -> (long)
heartbeatInSeconds -> (long)
activityStartedEventDetails -> (structure)
Содержит подробности о начале задачи во время выполнения.
workerName -> (string)
activitySucceededEventDetails -> (structure)
Содержит подробности об успешно завершённой задаче во время выполнения.
output -> (string)
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)
timeoutInSeconds -> (long)
heartbeatInSeconds -> (long)
taskCredentials -> (structure)
Удостоверения, которые Step Functions использует для задачи.
roleArn -> (string)
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)
outputDetails -> (structure)
Содержит подробности о выходе события истории выполнения.
truncated -> (boolean)
false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.taskSucceededEventDetails -> (structure)
Содержит подробности об успешном выполнении задачи.
resourceType -> (string)
resource -> (string)
output -> (string)
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)
inputDetails -> (structure)
Содержит подробности о входных данных для события истории выполнения.
truncated -> (boolean)
false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.roleArn -> (string)
stateMachineAliasArn -> (string)
stateMachineVersionArn -> (string)
executionSucceededEventDetails -> (structure)
Содержит подробности об успешном завершении выполнения.
output -> (string)
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)
mapIterationStartedEventDetails -> (structure)
Содержит подробности об итерации состояния Map, которая была начата.
name -> (строка)
index -> (целое число)
mapIterationSucceededEventDetails -> (структура)
Содержит подробности об итерации состояния Map, которая завершилась успешно.
name -> (строка)
index -> (целое число)
mapIterationFailedEventDetails -> (структура)
Содержит подробности об итерации состояния Map, которая завершилась неудачно.
name -> (строка)
index -> (целое число)
mapIterationAbortedEventDetails -> (структура)
Содержит подробности об итерации состояния Map, которая была прервана.
name -> (строка)
index -> (целое число)
lambdaFunctionFailedEventDetails -> (структура)
Содержит подробности о Lambda-функции, которая завершилась неудачно во время выполнения.
error -> (строка)
cause -> (строка)
lambdaFunctionScheduleFailedEventDetails -> (структура)
Содержит подробности о неудачном планировании Lambda-функции, которое произошло во время выполнения.
error -> (строка)
cause -> (строка)
lambdaFunctionScheduledEventDetails -> (структура)
Содержит подробности о запланированной Lambda-функции во время выполнения.
resource -> (строка)
input -> (строка)
inputDetails -> (структура)
Содержит подробности о вводе для события истории выполнения.
truncated -> (логическое значение)
false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.timeoutInSeconds -> (длинное целое число)
taskCredentials -> (структура)
Удостоверения, которые Step Functions использует для задачи.
roleArn -> (строка)
lambdaFunctionStartFailedEventDetails -> (структура)
Содержит подробности о Lambda-функции, которая не смогла запуститься во время выполнения.
error -> (строка)
cause -> (строка)
lambdaFunctionSucceededEventDetails -> (структура)
Содержит подробности о Lambda-функции, которая успешно завершилась во время выполнения.
output -> (строка)
outputDetails -> (структура)
Содержит подробности о выводе события истории выполнения.
truncated -> (логическое значение)
false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.lambdaFunctionTimedOutEventDetails -> (структура)
Содержит подробности о таймауте Lambda-функции, который произошел во время выполнения.
error -> (строка)
cause -> (строка)
stateEnteredEventDetails -> (структура)
Содержит подробности о состоянии, в которое вошли во время выполнения.
name -> (строка)
input -> (строка)
inputDetails -> (структура)
Содержит подробности об вводе для события истории выполнения.
truncated -> (логическое значение)
false для вызовов API. В журнале CloudWatch значение будет true, если данные усечены из-за ограничений размера.stateExitedEventDetails -> (структура)
Содержит подробности о выходе из состояния во время выполнения.
name -> (строка)
Имя состояния.
Имя не должно содержать:
- пробелы
- скобки
< > { } [ ] - символы подстановки
? * - специальные символы
" # % \ ^ | ~ ` $ & , ; : / - управляющие символы (
U+0000-001F,U+007F-009F)
Для включения ведения журнала с помощью CloudWatch Logs, имя должно содержать только 0-9, A-Z, a-z, -, и _.
output -> (строка)
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 -> (строка)
mapRunFailedEventDetails -> (структура)
Содержит подробности об ошибке и причине сбоя Map Run.
error -> (строка)
cause -> (строка)
mapRunRedrivenEventDetails -> (структура)
Содержит подробности о попытке перезапуска Map Run.
mapRunArn -> (строка)
redriveCount -> (целое число)
evaluationFailedEventDetails -> (структура)
Содержит подробности об ошибке оценки, которая произошла при обработке состояния.
error -> (строка)
cause -> (строка)
location -> (строка)
state -> (строка)
nextToken -> (строка)
nextToken, то есть больше результатов. Значение nextToken — это уникальный маркер постраничной навигации для каждой страницы. Повторите вызов, используя возвращённый маркер, чтобы получить следующую страницу. Не изменяйте другие аргументы. Каждый маркер постраничной навигации истекает через 24 часа. Использование истекшего маркера постраничной навигации вернёт ошибку HTTP 400 InvalidToken.
© Copyright 2025, Amazon Web Services. Created using Sphinx.