Spec-Zone.ru › AWS CLI v2

[ aws . stepfunctions ]

создать-активность

Описание

Создает активность. Активность — это задача, которую вы пишете на любом языке программирования и размещаете на любом компьютере, имеющем доступ к Step Functions. Активности должны опрашивать Step Functions с помощью действия API GetActivityTask и отвечать с помощью действий API SendTask*. Эта функция сообщает Step Functions о существовании вашей активности и возвращает идентификатор для использования в машине состояний и при опросе активности.

Примечание

Данная операция является согласованной в конечном итоге. Результаты выполняются в лучшем виде и могут не отражать очень последние обновления и изменения.

Примечание

CreateActivity — это идемпотентное API. Последующие запросы не создадут дублирующего ресурса, если он уже был создан. CreateActivity проверка идемпотентности основана на активности name. Если последующий запрос имеет другие значения tags, Step Functions проигнорирует эти различия и обработает его как идемпотентный запрос предыдущего. В этом случае tags не будет обновлен, даже если они отличаются.

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

Синтаксис

  create-activity
--name <value>
[--tags <value>]
[--encryption-configuration <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]

Параметры

--name (строка)

Имя создаваемой активности. Это имя должно быть уникальным для вашей учетной записи Amazon Web Services и региона в течение 90 дней. Дополнительную информацию см. в разделе Ограничения, связанные с выполнениями машины состояний, в руководстве разработчика Step Functions.

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

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

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

--tags (список)

Список тегов для добавления к ресурсу.

Массив пар ключ-значение. Дополнительную информацию см. в разделе Использование тегов распределения затрат в руководстве пользователя Amazon Web Services Billing and Cost Management и в разделе Управление доступом с помощью тегов IAM.

Теги могут содержать только символы Unicode, цифры, пробелы или следующие символы: _ . : / = + - @.

(структура)

Теги — это пары ключ-значение, которые могут быть связаны с машинами состояний и активностями Step Functions.

Массив пар ключ-значение. Дополнительную информацию см. в разделе Использование тегов распределения затрат в руководстве пользователя Amazon Web Services Billing and Cost Management и в разделе Управление доступом с помощью тегов IAM.

Теги могут содержать только символы Unicode, цифры, пробелы или следующие символы: _ . : / = + - @.

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

Ключ тега.

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

Значение тега.

Сокращенная форма:

key=string,value=string ...

Синтаксис JSON:

[
  {
    "key": "string",
    "value": "string"
  }
  ...
]

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

Настройки для настройки шифрования на стороне сервера.

kmsKeyId -> (строка)

Псевдоним, ARN псевдонима, ID ключа или ARN ключа симметричного ключа KMS для шифрования данных. Чтобы указать ключ KMS в другой учетной записи Amazon Web Services, необходимо использовать ARN ключа или ARN псевдонима.

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

Максимальное время, в течение которого Step Functions будет повторно использовать ключи данных. По истечении срока Step Functions вызовет GenerateDataKey. Применимо только к управляемым клиентом ключам.

тип -> (строка)

Тип шифрования

Сокращенная форма:

kmsKeyId=string,kmsDataKeyReusePeriodSeconds=integer,type=string

Синтаксис JSON:

{
  "kmsKeyId": "string",
  "kmsDataKeyReusePeriodSeconds": integer,
  "type": "AWS_OWNED_KEY"|"CUSTOMER_MANAGED_KMS_KEY"
}

--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 (boolean)

Включить отладку логирования.

--endpoint-url (string)

Переопределить URL команды указанным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определённый профиль из файла учетных данных.

--region (string)

Используемый регион. Переопределяет настройки из конфигурации/окружения.

--version (string)

Показать версию этого инструмента.

--color (string)

Включить/выключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки из конфигурации/окружения.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования для двоичных блоков. По умолчанию — 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 (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическое запросы параметров ввода CLI.

Вывод

activityArn -> (string)

Amazon Resource Name (ARN), идентифицирующий созданную задачу.

creationDate -> (timestamp)

Дата создания задачи.

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

Spec-Zone.ru

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