[ aws . cloudformation ]
create-stack-instances
Описание
Создаёт экземпляры стеков для указанных аккаунтов в указанных регионах Amazon Web Services. Экземпляр стека относится к стеку в определённом аккаунте и регионе. Вы должны указать хотя бы одно значение для Accounts или DeploymentTargets , и вы должны указать хотя бы одно значение для Regions .
См. также: Документация AWS API
Синтаксис
create-stack-instances
--stack-set-name <value>
[--accounts <value>]
[--deployment-targets <value>]
--regions <value>
[--parameter-overrides <value>]
[--operation-preferences <value>]
[--operation-id <value>]
[--call-as <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]
Параметры
--stack-set-name (строка)
--accounts (список)
[Самоуправляемые разрешения] Идентификаторы учетных записей одного или нескольких Amazon Web Services, в которых вы хотите создать экземпляры стеков в указанных регионах.
Вы можете указать Accounts или DeploymentTargets , но не оба.
(строка)
Синтаксис:
"string" "string" ...
--deployment-targets (структура)
[Разрешения, управляемые сервисом] Учетные записи Организации, для которых следует создать экземпляры стеков в указанных регионах Amazon Web Services.
Вы можете указать Accounts или DeploymentTargets , но не оба.
Accounts -> (список)
Идентификаторы учетных записей Amazon Web Services. Если у вас много номеров учетных записей, вы можете предоставить эти учетные записи, используя свойство AccountsUrl.
(строка)
AccountsUrl -> (строка)
.csv, либо .txt, и данные могут быть разделены запятыми или новой строкой. В настоящее время существует ограничение в 10 МБ для данных (приблизительно 800 000 учетных записей).OrganizationalUnitIds -> (список)
Идентификатор корневого объекта организации или идентификаторы подразделений (OU).
(строка)
AccountFilterType -> (строка)
Ограничить цели развертывания отдельными учетными записями или включить дополнительные учетные записи с предоставленными OU.
Следующее — список возможных значений для операции AccountFilterType.
-
INTERSECTION: StackSets развертывает в учетных записях, указанных в параметреAccounts. -
DIFFERENCE: StackSets исключает учетные записи, указанные в параметреAccounts. Это позволяет пользователю избегать определенных учетных записей в OU, таких как приостановленные учетные записи. -
UNION: StackSets включает дополнительные учетные записи в качестве целей развертывания. Это значение по умолчанию, еслиAccountFilterTypeне указано. Это позволяет пользователю обновлять всю OU и отдельные учетные записи из другой OU в одном запросе, что раньше требовало двух отдельных запросов. -
NONE: Развертывание во все учетные записи в указанных организационных подразделениях (OU).
Сокращённый синтаксис:
Accounts=string,string,AccountsUrl=string,OrganizationalUnitIds=string,string,AccountFilterType=string
Синтаксис JSON:
{
"Accounts": ["string", ...],
"AccountsUrl": "string",
"OrganizationalUnitIds": ["string", ...],
"AccountFilterType": "NONE"|"INTERSECTION"|"DIFFERENCE"|"UNION"
}
--regions (список)
Названия одного или нескольких регионов Amazon Web Services, где вы хотите создать экземпляры стеков, используя указанные учетные записи Amazon Web Services.
(строка)
Синтаксис:
"string" "string" ...
--parameter-overrides (список)
Список параметров набора стеков, значения которых вы хотите переопределить в выбранных экземплярах стеков.
Любые переопределенные значения параметров будут применены ко всем экземплярам стеков в указанных учетных записях и регионах Amazon Web Services. При указании параметров и их значений следует учитывать, как CloudFormation устанавливает значения параметров во время операций с экземплярами стеков:
- Для переопределения текущего значения параметра укажите параметр и его значение.
- Чтобы оставить переопределенный параметр с его текущим значением, укажите параметр и задайте
UsePreviousValueкакtrue. (Вы не можете указать и значение, и установитьUsePreviousValueв значениеtrue.) - Чтобы установить переопределенный параметр обратно на значение, указанное в наборе стеков, укажите список параметров, но не включайте параметр в список.
- Чтобы оставить все параметры со своими текущими значениями, не указывайте этот параметр вовсе.
Во время обновлений набора стеков любые переопределенные значения параметров для экземпляра стека не обновляются, а сохраняют своё переопределённое значение.
Вы можете переопределять только значения параметров, указанные в наборе стеков; чтобы добавить или удалить сам параметр, используйте UpdateStackSet для обновления шаблона набора стеков.
(структура)
Тип данных параметра.
ParameterKey -> (строка)
ParameterValue -> (строка)
UsePreviousValue -> (булево)
true, не указывайте значение параметра.ResolvedValue -> (строка)
Сокращённый синтаксис:
ParameterKey=string,ParameterValue=string,UsePreviousValue=boolean,ResolvedValue=string ...
Синтаксис JSON:
[
{
"ParameterKey": "string",
"ParameterValue": "string",
"UsePreviousValue": true|false,
"ResolvedValue": "string"
}
...
]
--operation-preferences (структура)
Настройки того, как CloudFormation выполняет данную операцию с набором стеков.
RegionConcurrencyType -> (строка)
RegionOrder -> (список)
Порядок регионов, в которых вы хотите выполнить операцию со стеком.
(строка)
FailureToleranceCount -> (целое число)
Количество учетных записей в каждом регионе, для которых данная операция может завершиться неудачно, прежде чем CloudFormation остановит операцию в этом регионе. Если операция останавливается в регионе, CloudFormation не пытается выполнить операцию в последующих регионах.
Условие: вы должны указать либо FailureToleranceCount, либо FailureTolerancePercentage (но не оба).
По умолчанию указано 0.
FailureTolerancePercentage -> (целое число)
Процент учетных записей в каждом регионе, для которых данная операция со стеком может завершиться неудачно, прежде чем CloudFormation остановит операцию в этом регионе. Если операция останавливается в регионе, CloudFormation не пытается выполнить операцию в последующих регионах.
При вычислении количества учетных записей на основе указанного процента CloudFormation округляет вниз до ближайшего целого числа.
Условие: вы должны указать либо FailureToleranceCount, либо FailureTolerancePercentage, но не оба.
По умолчанию указано 0.
MaxConcurrentCount -> (целое число)
Максимальное количество учетных записей, в которых следует выполнить эту операцию одновременно. Это может зависеть от значения FailureToleranceCount в зависимости от вашего ConcurrencyMode. MaxConcurrentCount не может быть больше, чем FailureToleranceCount +1, если вы используете STRICT_FAILURE_TOLERANCE.
Обратите внимание, что эта настройка позволяет указать максимум для операций. Для крупных развертываний в определенных ситуациях фактическое количество учетных записей, обрабатываемых одновременно, может быть ниже из-за ограничения сервиса.
Условие: вы должны указать либо MaxConcurrentCount, либо MaxConcurrentPercentage, но не оба.
По умолчанию указано 1.
MaxConcurrentPercentage -> (целое число)
Максимальный процент учетных записей, в которых следует выполнить эту операцию одновременно.
При вычислении количества учетных записей на основе указанного процента CloudFormation округляет вниз до ближайшего целого числа. Это верно, за исключением случаев, когда округление вниз приводит к нулю. В этом случае CloudFormation устанавливает это значение равным одному.
Обратите внимание, что эта настройка позволяет указать максимум для операций. Для крупных развертываний в определенных ситуациях фактическое количество учетных записей, обрабатываемых одновременно, может быть ниже из-за ограничения сервиса.
Условие: вы должны указать либо MaxConcurrentCount, либо MaxConcurrentPercentage, но не оба.
По умолчанию указано 1.
ConcurrencyMode -> (строка)
Указывает, как поведение уровня параллельности изменяется во время выполнения операции.
-
STRICT_FAILURE_TOLERANCE: Этот вариант динамически снижает уровень параллельности, чтобы гарантировать, что количество неудачных учетных записей никогда не превышает значениеFailureToleranceCount+1. Начальный фактический уровень параллельности устанавливается как меньшее из значенийMaxConcurrentCountилиFailureToleranceCount+1. Фактический уровень параллельности затем пропорционально уменьшается по количеству неудач. Это поведение по умолчанию. Если для толерантности к ошибкам или максимального количества одновременных учетных записей указаны проценты, поведение аналогичное. -
SOFT_FAILURE_TOLERANCE: Этот вариант отвязываетFailureToleranceCountот фактического уровня параллельности. Это позволяет операциям с набором стеков работать на уровне параллельности, заданном значениемMaxConcurrentCountилиMaxConcurrentPercentage, независимо от количества неудач.
Сокращённый синтаксис:
RegionConcurrencyType=string,RegionOrder=string,string,FailureToleranceCount=integer,FailureTolerancePercentage=integer,MaxConcurrentCount=integer,MaxConcurrentPercentage=integer,ConcurrencyMode=string
Синтаксис JSON:
{
"RegionConcurrencyType": "SEQUENTIAL"|"PARALLEL",
"RegionOrder": ["string", ...],
"FailureToleranceCount": integer,
"FailureTolerancePercentage": integer,
"MaxConcurrentCount": integer,
"MaxConcurrentPercentage": integer,
"ConcurrencyMode": "STRICT_FAILURE_TOLERANCE"|"SOFT_FAILURE_TOLERANCE"
}
--operation-id (строка)
Уникальный идентификатор этой операции с набором стеков.
Идентификатор операции также выполняет роль маркера идемпотентности, чтобы гарантировать, что CloudFormation выполнит операцию с набором стеков только один раз, даже если вы повторяете запрос несколько раз. Вы можете повторять запросы операций с набором стеков, чтобы убедиться, что CloudFormation их успешно получил.
Если вы не укажете идентификатор операции, SDK сгенерирует его автоматически.
Повтор этой операции с набором стеков с новым идентификатором операции повторно выполняет все экземпляры стеков, статус которых OUTDATED.
--call-as (строка)
[Разрешения, управляемые сервисом] Указывает, действуете ли вы как администратор учетной записи в учетной записи управления организацией или как делегированный администратор в учетной записи участника.
По умолчанию указано SELF. Используйте SELF для наборов стеков с самоуправляемыми разрешениями.
- Если вы вошли в учетную запись управления, укажите
SELF. - Если вы вошли в учетную запись делегированного администратора, укажите
DELEGATED_ADMIN. Ваша учетная запись Amazon Web Services должна быть зарегистрирована как делегированный администратор в учетной записи управления. Для получения дополнительной информации см. Регистрация делегированного администратора в Руководстве пользователя CloudFormation.
Возможные значения:
SELFDELEGATED_ADMIN
--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 ввода.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Более подробную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования наподобие Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Для создания экземпляров стека
Следующий create-stack-instances пример создает экземпляры набора стеков в двух учетных записях и в четырех регионах. Настройка отказоустойчивости гарантирует, что попытка обновления будет произведена во всех учетных записях и регионах, даже если некоторые стеки не могут быть созданы.
aws cloudformation create-stack-instances \
--stack-set-name my-stack-set \
--accounts 123456789012 223456789012 \
--regions us-east-1 us-east-2 us-west-1 us-west-2 \
--operation-preferences FailureToleranceCount=7
Вывод:
{
"OperationId": "d7995c31-83c2-xmpl-a3d4-e9ca2811563f"
}
Для создания набора стеков используйте команду create-stack-set.
Вывод
OperationId -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.