Spec-Zone.ru › AWS CLI v2

[ aws . swf ]

poll-for-activity-task

Описание

Используется рабочими процессами для получения ActivityTask из указанной активности taskList. Это инициирует длинный опрос, где служба поддерживает открытое HTTP-соединение и отвечает, как только задача станет доступной. Максимальное время, которое служба удерживает запрос перед ответом, составляет 60 секунд. Если задача недоступна в течение 60 секунд, опрос возвращает пустой результат. Пустой результат в этом контексте означает, что возвращается ActivityTask, но значение taskToken является пустой строкой. Если задача возвращается, рабочий процесс должен использовать её тип для правильной идентификации и обработки.

Предупреждение

Рабочие процессы должны установить таймаут сокета на стороне клиента как минимум на 70 секунд (на 10 секунд больше, чем максимальное время, которое служба может удерживать запрос опроса).

Контроль доступа

Вы можете использовать политики IAM для управления доступом к этому действию к ресурсам Amazon SWF следующим образом:

  • Используйте элемент Resource с именем домена, чтобы ограничить действие только указанными доменами.
  • Используйте элемент Action, чтобы разрешить или запретить разрешение на вызов этого действия.
  • Ограничьте параметр taskList.name, используя элемент Condition с ключом swf:taskList.name, чтобы разрешить действию доступ только к определённым спискам задач.

Если у вызывающего лица недостаточно разрешений для вызова действия или значения параметров выходят за пределы заданных ограничений, действие завершается неудачей. Соответствующий атрибут события устанавливает параметр cause в OPERATION_NOT_PERMITTED. Подробную информацию и примеры политик IAM см. в разделе «Использование IAM для управления доступом к рабочим процессам Amazon SWF» в Руководстве разработчика Amazon SWF.

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

Синтаксис

  poll-for-activity-task
--domain <value>
--task-list <value>
[--identity <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]

Параметры

--domain (строка)

Имя домена, содержащего списки задач, которые проверяются.

--task-list (структура)

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

Указанная строка не должна начинаться или заканчиваться пробелами. Она не должна содержать : (двоеточие), / (слеш), | (вертикальная черта) или любые управляющие символы (\u0000-\u001f | \u007f-\u009f ). Кроме того, она не должна быть литеральной строкой arn.

name -> (строка)

Имя списка задач.

Сокращённый синтаксис:

name=string

Синтаксис JSON:

{
  "name": "string"
}

--identity (строка)

Идентификатор рабочего процесса, производящего запрос, который записывается в событие ActivityTaskStarted в истории потока работ. Это позволяет производить диагностическое отслеживание при возникновении проблем. Формат этого идентификатора определяется пользователем.

--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, и в нём нет гарантий обратной совместимости.

Глобальные параметры

--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.

Вывод

taskToken -> (строка)

Непрозрачная строка, используемая как маркер задачи. Этот токен используется рабочими процессами для передачи информации о ходе выполнения и ответах системе о задаче.

activityId -> (строка)

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

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

Идентификатор события ActivityTaskStarted, записанного в истории.

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

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

workflowId -> (строка)

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

runId -> (строка)

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

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

Тип этой задачи активности.

name -> (строка)

Имя этой активности.

Примечание

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

version -> (строка)

Версия этой активности.

Примечание

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

input -> (строка)

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

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

Spec-Zone.ru

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