Spec-Zone.ru › AWS CLI v2

[ aws . stepfunctions ]

publish-state-machine-version

Описание

Создаёт версию текущей ревизии машины состояний. Используйте версии для создания неизменяемых снимков вашей машины состояний. Вы можете запускать исполнения из версий либо напрямую, либо с помощью алиаса. Для создания алиаса используйте CreateStateMachineAlias.

Вы можете опубликовать до 1000 версий для каждой машины состояний. Вы должны вручную удалить неиспользуемые версии, используя действие API DeleteStateMachineVersion.

PublishStateMachineVersion — это идемпотентный API. Он не создаёт дублирующей версии машины состояний, если она уже существует для текущей ревизии. Step Functions основывает проверку идемпотентности PublishStateMachineVersion на параметрах stateMachineArn, name и revisionId. Запросы с одинаковыми параметрами возвращают успешный идемпотентный ответ. Если вы не укажете revisionId, Step Functions проверяет наличие ранее опубликованной версии текущей ревизии машины состояний.

Связанные операции:

  • DeleteStateMachineVersion
  • ListStateMachineVersions

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

Синтаксис

  publish-state-machine-version
--state-machine-arn <value>
[--revision-id <value>]
[--description <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]

Параметры

--state-machine-arn (строка)

Amazon Resource Name (ARN) машины состояний.

--revision-id (строка)

Опубликовать версию машины состояний только если текущая ревизия машины состояний совпадает с указанным ID.

Используйте этот параметр, чтобы избежать публикации версии, если машина состояний изменилась с момента последнего обновления. Если указанный ID ревизии не совпадает с текущим ID ревизии машины состояний, API возвращает ConflictException.

Примечание

Для указания начального ID ревизии для машины состояний без назначенного ID ревизии, укажите строку INITIAL для параметра revisionId. Например, вы можете указать revisionID как INITIAL при создании машины состояний с помощью действия API CreateStateMachine.

--description (строка)

Необязательное описание версии машины состояний.

--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
  • 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 для вывода.

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Вывод

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

Дата создания версии.

stateMachineVersionArn -> (строка)

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

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

Spec-Zone.ru

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