Spec-Zone.ru › AWS CLI v2

[ aws . swf ]

describe-workflow-type

Описание

Возвращает информацию о заданном типе рабочей области. Это включает параметры конфигурации, указанные при регистрации типа, и другую информацию, такую как дата создания, текущий статус и т. д.

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

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

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

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

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

Синтаксис

  describe-workflow-type
--domain <value>
--workflow-type <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 (строка)

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

--workflow-type (структура)

Тип рабочей области, который требуется описать.

name -> (строка)

Имя типа рабочей области.

Примечание

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

version -> (строка)

Версия типа рабочей области.

Примечание

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

Сокращенная запись:

name=string,version=string

Синтаксис JSON:

{
  "name": "string",
  "version": "string"
}

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

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

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

Вывод

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

Общая информация о типе рабочего процесса.

Статус типа рабочего процесса (возвращаемый в структуре WorkflowTypeInfo) может быть одним из следующих.

  • REGISTERED – Тип зарегистрирован и доступен. Работники, поддерживающие этот тип, должны выполняться.
  • DEPRECATED – Тип был устаревшим с помощью DeprecateWorkflowType, но всё ещё используется. Вы должны поддерживать работу работников, поддерживающих этот тип. Вы не можете создавать новые выполнения рабочего процесса этого типа.

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

Тип рабочего процесса, к которому относится эта информация.

name -> (строка)

Название типа рабочего процесса.

Примечание

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

version -> (строка)

Версия типа рабочего процесса.

Примечание

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

status -> (строка)

Текущий статус типа рабочего процесса.

description -> (строка)

Описание типа, зарегистрированного с помощью RegisterWorkflowType.

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

Дата регистрации этого типа.

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

Если тип устарел, то он устанавливается на дату устаревания типа.

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

Настройки конфигурации типа рабочего процесса, зарегистрированного через RegisterWorkflowType

defaultTaskStartToCloseTimeout -> (строка)

Максимальная продолжительность по умолчанию, указанная при регистрации типа рабочего процесса, для выполнения задачи принятия решений для выполнений этого типа рабочего процесса перед возвратом завершения или ошибки. Если задача не завершается в указанное время, то задача автоматически завершается по тайм-ауту и перепланируется. Если принимающий решения в конечном итоге сообщает о завершении или ошибке, это игнорируется. Это значение по умолчанию может быть переопределено при запуске выполнения рабочего процесса с помощью действия StartWorkflowExecution или StartChildWorkflowExecution Decision.

Продолжительность указывается в секундах, целое число, больше или равное 0. Вы можете использовать NONE для указания неограниченной продолжительности.

defaultExecutionStartToCloseTimeout -> (строка)

Максимальная продолжительность по умолчанию, указанная при регистрации типа рабочего процесса, для выполнений этого типа рабочего процесса. Это значение по умолчанию может быть переопределено при запуске выполнения рабочего процесса с помощью действия StartWorkflowExecution или StartChildWorkflowExecution Decision.

Продолжительность указывается в секундах, целое число, больше или равное 0. Вы можете использовать NONE для указания неограниченной продолжительности.

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

Список задач по умолчанию, указанный при регистрации типа рабочего процесса, для задач принятия решений, запланированных для выполнений рабочего процесса этого типа. Это значение по умолчанию может быть переопределено при запуске выполнения рабочего процесса с помощью действия StartWorkflowExecution или StartChildWorkflowExecution Decision.

name -> (строка)

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

defaultTaskPriority -> (строка)

Приоритет задач по умолчанию, указанный при регистрации типа рабочего процесса, для всех задач принятия решений этого типа рабочего процесса. Это значение по умолчанию может быть переопределено при запуске выполнения рабочего процесса с помощью действия StartWorkflowExecution или StartChildWorkflowExecution decision.

Допустимые значения — целые числа в диапазоне от Integer.MIN_VALUE (-2147483648) до Integer.MAX_VALUE (2147483647). Более высокие числа указывают на более высокий приоритет.

Дополнительную информацию о настройке приоритета задач см. в разделе Установка приоритета задач в Руководстве разработчика Amazon SWF.

defaultChildPolicy -> (строка)

Политика по умолчанию для дочерних выполнений рабочего процесса при завершении выполнения рабочего процесса этого типа, вызывая действие TerminateWorkflowExecution явно или из-за истечения тайм-аута. Это значение по умолчанию может быть переопределено при запуске выполнения рабочего процесса с помощью действия StartWorkflowExecution или StartChildWorkflowExecution Decision.

Поддерживаемые политики для дочерних задач:

  • TERMINATE – Дочерние выполнения завершаются.
  • REQUEST_CANCEL – Попытка отмены производится для каждого дочернего выполнения путём записи события WorkflowExecutionCancelRequested в его истории. Принимающий решение должен принять соответствующие действия при получении истории выполнения с этим событием.
  • ABANDON – Никаких действий не предпринимается. Дочерние выполнения продолжают выполняться.

defaultLambdaRole -> (строка)

Роль IAM по умолчанию, прикреплённая к этому типу рабочего процесса.

Примечание

Выполнения этого типа рабочего процесса нуждаются в ролях IAM для вызова функций Lambda. Если вы не указываете роль IAM при запуске этого типа рабочего процесса, по умолчанию к выполнению прикрепляется роль Lambda. Дополнительную информацию см. на странице https://docs.aws.amazon.com/amazonswf/latest/developerguide/lambda-task.html в Руководстве разработчика Amazon SWF.

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

Spec-Zone.ru

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