aws cloudformation update-stack-set

Updates the StackSet and associated stack instances in the specified accounts and Amazon Web Services Regions. AWS CLI reference

1 example 19 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

To update a stack set

The following update-stack-set example adds a tag with the key name Owner and a value of IT to the stack instances in the specified stack set.

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

--stack-set-nameThe name or unique ID of the StackSet that you want to update.

--use-previous-templateUse the existing template that's associated with the StackSet that you're updating.

--tagsThe key-value pairs to associate with this StackSet and the stacks created from it.

Its output

{
    "OperationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

For more information, see Update CloudFormation StackSets in the AWS CloudFormation User Guide.

Options

19 in the AWS CLI reference

--accounts[Self-managed permissions] The accounts in which to update associated stack instances.

--administration-role-arn[Self-managed permissions] The Amazon Resource Name (ARN) of the IAM role to use to update this StackSet.

--auto-deployment[Service-managed permissions] Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit (OU).

--call-as[Service-managed permissions] Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account.

--capabilitiesIn some cases, you must explicitly acknowledge that your stack template contains certain capabilities in order for CloudFormation to update the StackSet and its associated stack instances.

--deployment-targets[Service-managed permissions] The Organizations accounts in which to update associated stack instances.

--descriptionA brief description of updates that you are making.

--execution-role-name[Self-managed permissions] The name of the IAM execution role to use to update the stack set.

--managed-executionDescribes whether CloudFormation performs non-conflicting operations concurrently and queues conflicting operations.

--operation-idThe unique ID for this StackSet operation.

--operation-preferencesPreferences for how CloudFormation performs this StackSet operation.

--parametersA list of input parameters for the StackSet template.

--permission-modelDescribes how the IAM roles required for StackSet operations are created.

--regionsThe Amazon Web Services Regions in which to update associated stack instances.

--stack-set-nameThe name or unique ID of the StackSet that you want to update.

--tagsThe key-value pairs to associate with this StackSet and the stacks created from it.

--template-bodyThe structure that contains the template body, with a minimum length of 1 byte and a maximum length of 51,200 bytes.

--template-urlThe URL of a file that contains the template body.

--use-previous-templateUse the existing template that's associated with the StackSet that you're updating.