[ AWS CLI Command Reference ](../../index.html)

  * [ Home ](../../index.html)
  * [ User Guide ](https://docs.aws.amazon.com/cli/latest/userguide/)
  * [ Forum ](https://forums.aws.amazon.com/forum.jspa?forumID=150)
  * [ GitHub ](https://github.com/aws/aws-cli)

###  Navigation

  * [ index ](../../genindex.html "General Index")
  * [ next ](create-generated-template.html "create-generated-template") | 
  * [ previous ](continue-update-rollback.html "continue-update-rollback") | 
  * [ AWS CLI 2.15.40 Command Reference ](../../index.html) » 
  * [ aws ](../index.html) » 
  * [ cloudformation ](index.html) » 

  * [ ← continue-update-rollback ](continue-update-rollback.html "previous chapter \(use the left arrow\)") / 
  * [ create-generated-template → ](create-generated-template.html "next chapter \(use the right arrow\)")

[ ![Amazon Web Services logo](../../_static/logo.png) ](../../index.html)

###  [ Table of Contents ](../../index.html)

  * create-change-set 
    * Description 
    * Synopsis 
    * Options 
    * Global Options 
    * Examples 
    * Output 

###  Quick search

Search box  Search

###  Feedback

Did you find this page useful? Do you have a suggestion to improve the
documentation? [ Give us feedback ](https://docs.aws.amazon.com/forms/aws-doc-
feedback?hidden_service_name=AWS%20Command%20Line%20Interface&hidden_guide_name=Reference&topic_url=https%3A%2F%2Fdocs.aws.amazon.com%2Fcli%2Flatest%2Freference/cloudformation/create-
change-set.html) .  
If you would like to suggest an improvement or fix for the AWS CLI, check out
our [ contributing guide ](https://github.com/aws/aws-
cli/blob/develop/CONTRIBUTING.md) on GitHub.

###  User Guide

First time using the AWS CLI? See the [ User Guide
](https://docs.aws.amazon.com/cli/latest/userguide/) for help getting started.

[ [ aws  ](../index.html#cli-aws) . [ cloudformation  ](index.html#cli-aws-
cloudformation) ]

#  create-change-set  Â¶

##  Description  Â¶

Creates a list of changes that will be applied to a stack so that you can
review the changes before executing them. You can create a change set for a
stack that doesnât exist or an existing stack. If you create a change set
for a stack that doesnât exist, the change set shows all of the resources
that CloudFormation will create. If you create a change set for an existing
stack, CloudFormation compares the stackâs information with the information
that you submit in the change set and lists the differences. Use change sets
to understand which resources CloudFormation will create or change, and how it
will change resources in an existing stack, before you create or update a
stack.

To create a change set for a stack that doesnât exist, for the `
ChangeSetType  ` parameter, specify ` CREATE  ` . To create a change set for
an existing stack, specify ` UPDATE  ` for the ` ChangeSetType  ` parameter.
To create a change set for an import operation, specify ` IMPORT  ` for the `
ChangeSetType  ` parameter. After the ` CreateChangeSet  ` call successfully
completes, CloudFormation starts creating the change set. To check the status
of the change set or to review it, use the DescribeChangeSet action.

When you are satisfied with the changes the change set will make, execute the
change set by using the ExecuteChangeSet action. CloudFormation doesnât make
changes until you execute the change set.

To create a change set for the entire stack hierarchy, set `
IncludeNestedStacks  ` to ` True  ` .

See also: [ AWS API Documentation
](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)

##  Synopsis  Â¶

    
    
      create-change-set
    --stack-name <value>
    [--template-body <value>]
    [--template-url <value>]
    [--use-previous-template | --no-use-previous-template]
    [--parameters <value>]
    [--capabilities <value>]
    [--resource-types <value>]
    [--role-arn <value>]
    [--rollback-configuration <value>]
    [--notification-arns <value>]
    [--tags <value