update-stack-set

Описание

Обновляет набор стеков и связанные экземпляры стеков в указанных учетных записях и регионах Amazon Web Services.

Даже если операция с набором стеков, созданная при обновлении набора стеков, завершается неудачно (полностью или частично, ниже или выше заданной допустимой ошибки), набор стеков обновляется с внесёнными изменениями. Последующие вызовы CreateStackInstances для указанного набора стеков используют обновлённый набор стеков.

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

Синтаксис

  update-stack-set
--stack-set-name <value>
[--description <value>]
[--template-body <value>]
[--template-url <value>]
[--use-previous-template | --no-use-previous-template]
[--parameters <value>]
[--capabilities <value>]
[--tags <value>]
[--operation-preferences <value>]
[--administration-role-arn <value>]
[--execution-role-name <value>]
[--deployment-targets <value>]
[--permission-model <value>]
[--auto-deployment <value>]
[--operation-id <value>]
[--accounts <value>]
[--regions <value>]
[--call-as <value>]
[--managed-execution <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 (строка)

Имя или уникальный идентификатор набора стеков, который вы хотите обновить.

--description (строка)

Краткое описание обновлений, которые вы производите.

--template-body (строка)

Структура, содержащая тело шаблона, с минимальной длиной 1 байт и максимальной длиной 51 200 байт.

Условие: Вы должны указать только один из следующих параметров: TemplateBody или TemplateURL —или установить UsePreviousTemplate в значение true.

--template-url (строка)

URL файла, содержащего тело шаблона. URL должен указывать на шаблон (максимальный размер: 1 МБ), расположенный в ведре Amazon S3 или документе Systems Manager. Путь к ведру Amazon S3 должен начинаться с https://.

--use-previous-template | --no-use-previous-template (логическое значение)

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

--parameters (список)

Список входных параметров шаблона набора стеков.

(структура)

Тип данных параметра.

ParameterKey -> (строка)

Ключ, связанный с параметром. Если вы не укажете ключ и значение для определенного параметра, CloudFormation использует значение по умолчанию, указанное в вашем шаблоне.

ParameterValue -> (строка)

Входное значение, связанное с параметром.

UsePreviousValue -> (логическое значение)

Во время обновления стека использовать существующее значение параметра, используемое стеком для данного ключа параметра. Если вы указываете true, не указывайте значение параметра.

ResolvedValue -> (строка)

Только для чтения. Значение, соответствующее ключу параметра Systems Manager. Это поле возвращается только для типов параметров Systems Manager в шаблоне. Дополнительную информацию см. в разделе Указание существующих ресурсов во время выполнения с типами параметров, предоставляемыми CloudFormation, в руководстве пользователя CloudFormation.

Сокращенная синтаксическая запись:

ParameterKey=string,ParameterValue=string,UsePreviousValue=boolean,ResolvedValue=string ...

Синтаксис JSON:

[
  {
    "ParameterKey": "string",
    "ParameterValue": "string",
    "UsePreviousValue": true|false,
    "ResolvedValue": "string"
  }
  ...
]

--capabilities (список)

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

CAPABILITY_IAM и CAPABILITY_NAMED_IAM Некоторые шаблоны стеков могут содержать ресурсы, которые могут повлиять на разрешения в вашей учетной записи Amazon Web Services, например, создавая новых пользователей IAM. Для этих наборов стеков вы должны явно подтвердить это, указав одну из этих возможностей. Следующие ресурсы IAM требуют указания либо возможности CAPABILITY_IAM, либо CAPABILITY_NAMED_IAM.
- Если у вас есть ресурсы IAM, вы можете указать любую из этих возможностей.
- Если у вас есть ресурсы IAM с пользовательскими именами, вы обязательно должны указать CAPABILITY_NAMED_IAM.
- Если вы не укажете ни одну из этих возможностей, CloudFormation вернет ошибку InsufficientCapabilities.

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

AWS::IAM::AccessKey
AWS::IAM::Group
AWS::IAM::InstanceProfile
AWS::IAM::Policy
AWS::IAM::Role
AWS::IAM::User
AWS::IAM::UserToGroupAddition

Дополнительную информацию см. в разделе Подтверждение ресурсов IAM в шаблонах CloudFormation.

CAPABILITY_AUTO_EXPAND Некоторые шаблоны ссылаются на макросы. Если шаблон вашего набора стеков ссылается на один или несколько макросов, вы должны обновить набор стеков непосредственно из обработанного шаблона, не просматривая сначала результаты изменений в наборе изменений. Чтобы обновить набор стеков напрямую, вы должны подтвердить эту возможность. Дополнительную информацию см. в разделе Выполнение пользовательской обработки шаблонов CloudFormation с макросами шаблонов.

Предупреждение

Наборы стеков с управляемыми службой разрешениями в настоящее время не поддерживают использование макросов в шаблонах. (Это включает преобразования AWS::Include и AWS::Serverless, которые являются макросами, размещенными CloudFormation.) Даже если вы укажете эту возможность для набора стеков с управляемыми службой разрешениями, если вы ссылаетесь на макрос в вашем шаблоне, операция с набором стеков завершится ошибкой.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  CAPABILITY_IAM
  CAPABILITY_NAMED_IAM
  CAPABILITY_AUTO_EXPAND

--tags (список)

Список пар «ключ-значение», которые нужно связать с этим набором стеков и стеками, созданными из него. CloudFormation также распространяет эти теги на поддерживаемые ресурсы, которые создаются в стеках. Вы можете указать максимальное количество 50 тегов.

Если вы указываете теги для этого параметра, эти теги заменяют любой список тегов, который в настоящее время связан с этим набором стеков. Это означает:

Если вы не указываете этот параметр, CloudFormation не изменяет теги стека.
Если вы указываете любые теги с помощью этого параметра, вы должны указать все теги, которые вы хотите связать с этим набором стеков, даже теги, которые вы указали ранее (например, при создании набора стеков или во время предыдущего обновления набора стеков). Любые теги, которые вы не включаете в обновленный список тегов, удаляются из набора стеков, а следовательно, и из стеков и ресурсов.
Если вы указываете пустое значение, CloudFormation удаляет все связанные в настоящее время теги.

Если вы указываете новые теги как часть действия UpdateStackSet, CloudFormation проверяет, имеете ли вы необходимые разрешения IAM для маркировки ресурсов. Если вы опускаете теги, которые в настоящее время связаны с набором стеков, из списка указанных вами тегов, CloudFormation предполагает, что вы хотите удалить эти теги из набора стеков и проверяет, имеете ли вы разрешение на удаление тегов из ресурсов. Если у вас нет необходимых разрешений, все действие UpdateStackSet завершится ошибкой access denied, и набор стеков не будет обновлен.

(структура)

Тип тега позволяет вам указать пару «ключ-значение», которая может использоваться для хранения информации о стеке CloudFormation.

Key -> (строка)

Обязательно. Строка, используемая для идентификации этого тега. Вы можете указать не более 128 символов для ключа тега. Теги, принадлежащие Amazon Web Services, имеют зарезервированный префикс: aws:.

Value -> (строка)

Обязательно. Строка, содержащая значение для этого тега. Вы можете указать не более 256 символов для значения тега.

Сокращенная синтаксическая запись:

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--operation-preferences (структура)

Настройки того, как CloudFormation выполняет эту операцию с набором стеков.

RegionConcurrencyType -> (строка)

Тип параллельности развертывания операций StackSets в регионах, может быть параллельной или по одному региону за раз.

RegionOrder -> (список)

Порядок регионов, в которых вы хотите выполнить операцию со стеком.

(строка)

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

Количество учетных записей в каждом регионе, для которых эта операция может завершиться ошибкой, прежде чем CloudFormation остановит операцию в этом регионе. Если операция остановлена в регионе, CloudFormation не пытается выполнить операцию в последующих регионах.

Условие: Вы должны указать либо FailureToleranceCount, либо FailureTolerancePercentage (но не оба).

По умолчанию указано 0.

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

Процент учетных записей в каждом регионе, для которых эта операция со стеком может завершиться ошибкой, прежде чем CloudFormation остановит операцию в этом регионе. Если операция остановлена в регионе, CloudFormation не пытается выполнить операцию в последующих регионах.

При расчете количества учетных записей на основе указанного процента CloudFormation округляет вниз до ближайшего целого числа.

Условие: Вы должны указать либо FailureToleranceCount, либо FailureTolerancePercentage, но не оба.

По умолчанию указано 0.

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

Максимальное количество учетных записей, в которых можно выполнить эту операцию за один раз. Это может зависеть от значения FailureToleranceCount в зависимости от вашего ConcurrencyMode. MaxConcurrentCount не больше, чем FailureToleranceCount, если вы используете STRICT_FAILURE_TOLERANCE.

Обратите внимание, что это значение позволяет указать максимум для операций. Для крупных развертываний в определенных обстоятельствах фактическое количество учетных записей, обработанных одновременно, может быть меньше из-за ограничения скорости службы.

Условие: Вы должны указать либо MaxConcurrentCount, либо MaxConcurrentPercentage, но не оба.

По умолчанию указано 1.

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

Максимальный процент учетных записей, в которых можно выполнить эту операцию за один раз.

При расчете количества учетных записей на основе указанного процента CloudFormation округляет вниз до ближайшего целого числа. Это верно, за исключением случаев, когда округление вниз приводит к нулю. В этом случае CloudFormation устанавливает это число в 1.

Условие: Вы должны указать либо 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"
}

--administration-role-arn (строка)

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

Укажите роль IAM только в том случае, если вы используете настраиваемые роли администратора для управления тем, какие пользователи или группы могут управлять конкретными наборами стеков в рамках одной учетной записи администратора. Дополнительную информацию см. в разделе Назначение самоуправляемых разрешений в руководстве CloudFormation User Guide.

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

--execution-role-name (строка)

[Самоуправляемые разрешения] Имя роли IAM выполнения, используемой для обновления набора стеков. Если вы не укажете роль выполнения, CloudFormation использует роль AWSCloudFormationStackSetExecutionRole для операции с набором стеков.

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

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

--deployment-targets (структура)

[Разрешения, управляемые службой] Учетные записи Организации, в которых необходимо обновить связанные экземпляры стеков.

Для обновления всех связанных с этим набором стеков экземпляров стеков не указывайте DeploymentTargets или Regions.

Если обновление набора стеков включает изменения в шаблоне (то есть, если указано TemplateBody или TemplateURL) или Parameters, CloudFormation помечает все экземпляры стеков статусом OUTDATED перед обновлением экземпляров стеков в указанных учетных записях и регионах Amazon Web Services. Если обновление набора стеков не включает изменений в шаблоне или параметрах, CloudFormation обновляет экземпляры стеков в указанных учетных записях и регионах, оставляя все остальные экземпляры стеков с их текущим статусом экземпляра стека.

Accounts -> (список)

Идентификаторы учетных записей Amazon Web Services. Если у вас много номеров учетных записей, вы можете предоставить эти учетные записи с помощью свойства AccountsUrl вместо этого.

(строка)

AccountsUrl -> (строка)

Путь к URL-адресу Amazon S3 к файлу, содержащему список идентификаторов учетных записей Amazon Web Services. Формат файла должен быть либо .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"
}

--permission-model (строка)

Описание того, как создаются роли IAM, необходимые для операций с наборами стеков. Вы не можете изменить PermissionModel, если существуют экземпляры стеков, связанные с вашим набором стеков.

С разрешениями self-managed вы должны создать роли администратора и выполнения, необходимые для развертывания в целевых учетных записях. Дополнительную информацию см. в разделе Назначение самоуправляемых разрешений.
С разрешениями service-managed StackSets автоматически создает роли IAM, необходимые для развертывания в учетных записях, управляемых Организациями. Дополнительную информацию см. в разделе Активация доверенного доступа для наборов стеков с разрешениями, управляемыми службой.

Возможные значения:

SERVICE_MANAGED
SELF_MANAGED

--auto-deployment (структура)

[Разрешения, управляемые службой] Описывает, автоматически ли StackSets развертывает в учетные записи Организации, добавляемые в целевую организацию или организационную единицу (OU). Дополнительную информацию см. в разделе Управление автоматическими развертываниями для наборов стеков CloudFormation, использующих разрешения, управляемые службой, в руководстве CloudFormation User Guide.

Если вы укажете AutoDeployment, не указывайте DeploymentTargets или Regions.

Enabled -> (булево)

Если установлено значение true, StackSets автоматически развертывает дополнительные экземпляры стеков в учетные записи Организации, которые добавлены в целевую организацию или организационную единицу (OU) в указанных регионах. Если учетная запись удалена из целевой организации или OU, StackSets удаляет экземпляры стеков из учетной записи в указанных регионах.

RetainStacksOnAccountRemoval -> (булево)

Если установлено значение true, ресурсы стека сохраняются при удалении учетной записи из целевой организации или OU. Если установлено значение false, ресурсы стека удаляются. Указывается только в том случае, если Enabled установлено в значение True.

Сокращенная запись:

Enabled=boolean,RetainStacksOnAccountRemoval=boolean

Синтаксис JSON:

{
  "Enabled": true|false,
  "RetainStacksOnAccountRemoval": true|false
}

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

Уникальный идентификатор этой операции с набором стеков.

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

Если вы не укажете идентификатор операции, CloudFormation сгенерирует его автоматически.

Повтор этой операции с набором стеков с новым идентификатором операции повторно выполняет все экземпляры стеков, статус которых OUTDATED.

--accounts (список)

[Самоуправляемые разрешения] Учетные записи, в которых необходимо обновить связанные экземпляры стеков. Если вы укажете учетные записи, вы также должны указать регионы Amazon Web Services, в которых необходимо обновить экземпляры наборов стеков.

Чтобы обновить все связанные с этим набором стеков экземпляры стеков, не указывайте свойства Accounts или Regions.

Если обновление набора стеков включает изменения в шаблоне (то есть, если указаны свойства TemplateBody или TemplateURL), или свойство Parameters, CloudFormation помечает все экземпляры стеков статусом OUTDATED перед обновлением экземпляров стеков в указанных учетных записях и регионах Amazon Web Services. Если обновление набора стеков не включает изменений в шаблоне или параметрах, CloudFormation обновляет экземпляры стеков в указанных учетных записях и регионах, оставляя все остальные экземпляры стеков с их текущим статусом экземпляра стека.

(строка)

Синтаксис:

"string" "string" ...

--regions (список)

Регионы Amazon Web Services, в которых необходимо обновить связанные экземпляры стеков. Если вы укажете регионы, вы также должны указать учетные записи, в которых необходимо обновить экземпляры набора стеков.

Если обновление набора стеков включает изменения в шаблоне (то есть, если указаны свойства TemplateBody или TemplateURL), или свойство Parameters, CloudFormation помечает все экземпляры стеков статусом OUTDATED перед обновлением экземпляров стеков в указанных учетных записях и регионах. Если обновление набора стеков не включает изменений в шаблоне или параметрах, CloudFormation обновляет экземпляры стеков в указанных учетных записях и регионах, оставляя все остальные экземпляры стеков с их текущим статусом экземпляра стека.

(строка)

Синтаксис:

"string" "string" ...

--call-as (строка)

[Разрешения, управляемые службой] Указывает, действуете ли вы в качестве администратора учетной записи в учетной записи управления организацией или в качестве делегированного администратора в учетной записи участника.

По умолчанию указано SELF. Используйте SELF для наборов стеков с самоуправляемыми разрешениями.

Если вы вошли в учетную запись управления, укажите SELF.
Если вы вошли в учетную запись делегированного администратора, укажите DELEGATED_ADMIN. Ваша учетная запись Amazon Web Services должна быть зарегистрирована как делегированный администратор в учетной записи управления. Дополнительную информацию см. в разделе Регистрация делегированного администратора в руководстве CloudFormation User Guide.

Возможные значения:

SELF
DELEGATED_ADMIN

--managed-execution (структура)

Описание того, выполняют ли StackSets неконфликтующие операции одновременно и добавляют конфликтующие операции в очередь.

Active -> (булево)

При значении true StackSets выполняет неконфликтующие операции одновременно и добавляет конфликтующие операции в очередь. После завершения конфликтующих операций StackSets запускает операции из очереди в порядке запроса.

Примечание

Если уже выполняются или находятся в очереди операции, StackSets добавляет все входящие операции в очередь, даже если они неконфликтующие.

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

При значении false (по умолчанию) StackSets выполняет по одной операции за раз в порядке запроса.

Сокращенная запись:

Active=boolean

Синтаксис JSON:

{
  "Active": true|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
текст
таблица
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-auto-prompt (логическое значение)

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

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

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

Примеры

Примечание

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

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

Для обновления набора стеков

Следующий update-stack-set пример добавляет тег с именем ключа Owner и значением IT к экземплярам стека в указанном наборе стеков.

aws cloudformation update-stack-set \
    --stack-set-name my-stack-set \
    --use-previous-template \
    --tags Key=Owner,Value=IT

Вывод:

{
    "OperationId": "e2b60321-6cab-xmpl-bde7-530c6f47950e"
}

Вывод

OperationId -> (строка)

Уникальный идентификатор этой операции набора стеков.