[ aws . stepfunctions ]
создать-алиас-машины-состояний
Описание
Создаёт алиас для машины состояний, указывающий на одну или две версии той же машины состояний. Вы можете настроить своё приложение на вызов StartExecution с алиасом и обновить версию, используемую алиасом, без изменения кода клиента.
Вы также можете сопоставить алиас, чтобы разделить запросы StartExecution между двумя версиями машины состояний. Для этого добавьте второй объект RoutingConfig в параметре routingConfiguration. Вы также должны указать процент запросов выполнения, которые должна получать каждая версия, в обоих объектах RoutingConfig. Step Functions случайным образом выбирает, какая версия выполняет данное выполнение, основываясь на заданном вами проценте.
Чтобы создать алиас, указывающий на одну версию, укажите один объект RoutingConfig с weight, установленным в 100.
Вы можете создать до 100 алиасов для каждой машины состояний. Вы должны удалить неиспользуемые алиасы, используя действие API DeleteStateMachineAlias.
CreateStateMachineAlias — это идемпотентный API. Step Functions основывает проверку идемпотентности на параметрах stateMachineArn, description, name и routingConfiguration. Запросы, содержащие одинаковые значения для этих параметров, возвращают успешный идемпотентный ответ без создания дублирующего ресурса.
Связанные операции:
- DescribeStateMachineAlias
- ListStateMachineAliases
- UpdateStateMachineAlias
- DeleteStateMachineAlias
См. также: AWS API Documentation
Синтаксис
create-state-machine-alias
[--description <value>]
--name <value>
--routing-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]
Параметры
--description (строка)
--name (строка)
Имя алиаса машины состояний.
Чтобы избежать конфликтов с ARNs версий, не используйте целое число в имени алиаса.
--routing-configuration (список)
Конфигурация маршрутизации алиаса машины состояний. Конфигурация маршрутизации перенаправляет трафик выполнения между двумя версиями машины состояний. routingConfiguration содержит массив объектов RoutingConfig, которые указывают до двух версий машины состояний. Step Functions затем случайным образом выбирает, какую версию использовать для выполнения, основываясь на весах, присвоенных каждому RoutingConfig.
(структура)
Содержит сведения о конфигурации маршрутизации алиаса машины состояний. В конфигурации маршрутизации вы определяете массив объектов, которые указывают до двух версий машины состояний. Вы также указываете процент трафика, который будет направлен в каждую версию.
stateMachineVersionArn -> (строка)
Amazon Resource Name (ARN), определяющий одну или две версии машины состояний, определённые в конфигурации маршрутизации.
Если вы указываете ARN второй версии, она должна принадлежать той же машине состояний, что и первая версия.
weight -> (целое число)
Сокращённый синтаксис:
stateMachineVersionArn=string,weight=integer ...
Синтаксис JSON:
[
{
"stateMachineVersionArn": "string",
"weight": integer
}
...
]
--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.
Вывод
stateMachineAliasArn -> (строка)
creationDate -> (метка времени)
© Copyright 2025, Amazon Web Services. Created using Sphinx.