execute-change-set

Описание

Обновляет стек, используя входную информацию, предоставленную при создании указанного набора изменений. После успешного выполнения вызова CloudFormation начинает обновление стека. Используйте действие DescribeStacks, чтобы просмотреть статус обновления.

При выполнении набора изменений CloudFormation удаляет все другие наборы изменений, связанные со стеком, поскольку они недействительны для обновлённого стека.

Если для стека задана политика стека, CloudFormation применяет эту политику во время обновления. Вы не можете указать временную политику стека, которая переопределяет текущую политику.

Для создания набора изменений для всей иерархии стека IncludeNestedStacks должно быть установлено в True .

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

Синтаксис

  execute-change-set
--change-set-name <value>
[--stack-name <value>]
[--client-request-token <value>]
[--disable-rollback | --no-disable-rollback]
[--retain-except-on-create | --no-retain-except-on-create]
[--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]

Параметры

--change-set-name (строка)

Имя или Amazon Resource Name (ARN) набора изменений, который вы хотите использовать для обновления указанного стека.

--stack-name (строка)

Если вы указали имя набора изменений, укажите имя стека или Amazon Resource Name (ARN), связанный с набором изменений, который вы хотите выполнить.

--client-request-token (строка)

Уникальный идентификатор для этого ExecuteChangeSet запроса. Укажите этот маркер, если планируете повторные запросы, чтобы CloudFormation знал, что вы не пытаетесь выполнить набор изменений для обновления стека с тем же именем. Вы можете повторить ExecuteChangeSet запросы, чтобы убедиться, что CloudFormation их успешно получил.

--disable-rollback | --no-disable-rollback (логическое значение)

Сохраняет состояние ранее подготовленных ресурсов при сбое операции. Этот параметр не может быть указан при указании параметра OnStackFailure в операции CreateChangeSet API.

True - если создание стека завершается ошибкой, ничего не делать. Это эквивалентно указанию DO_NOTHING для параметра OnStackFailure операции CreateChangeSet API.
False - если создание стека завершается ошибкой, откатить стек. Это эквивалентно указанию ROLLBACK для параметра OnStackFailure операции CreateChangeSet API.

По умолчанию: True

--retain-except-on-create | --no-retain-except-on-create (логическое значение)

При установке в true, вновь созданные ресурсы удаляются при откате операции. Это включает вновь созданные ресурсы, помеченные политикой удаления Retain .

По умолчанию: false

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

Примеры

Примечание

Для использования следующих примеров вам необходимо установить и настроить AWS CLI. Подробности см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, во всех примерах используются правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для выполнения набора изменений

Следующий execute-change-set пример выполняет набор изменений, указанный именем набора изменений и именем стека.

aws cloudformation execute-change-set \
    --change-set-name my-change-set \
    --stack-name my-stack

Следующий execute-change-set пример выполняет набор изменений, указанный полным ARN набора изменений.

aws cloudformation execute-change-set \
    --change-set-name arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/bc9555ba-a949-xmpl-bfb8-f41d04ec5784

Вывод

Нет