[ 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 ](list-exports.html "list-exports") | 
  * [ previous ](import-stacks-to-stack-set.html "import-stacks-to-stack-set") | 
  * [ AWS CLI 2.15.40 Command Reference ](../../index.html) » 
  * [ aws ](../index.html) » 
  * [ cloudformation ](index.html) » 

  * [ ← import-stacks-to-stack-set ](import-stacks-to-stack-set.html "previous chapter \(use the left arrow\)") / 
  * [ list-exports → ](list-exports.html "next chapter \(use the right arrow\)")

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

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

  * list-change-sets 
    * 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/list-
change-sets.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) ]

#  list-change-sets  Â¶

##  Description  Â¶

Returns the ID and status of each active change set for a stack. For example,
CloudFormation lists change sets that are in the ` CREATE_IN_PROGRESS  ` or `
CREATE_PENDING  ` state.

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

` list-change-sets  ` is a paginated operation. Multiple API calls may be
issued in order to retrieve the entire data set of results. You can disable
pagination by providing the ` --no-paginate  ` argument. When using ` --output
text  ` and the ` --query  ` argument on a paginated response, the ` --query
` argument must extract data from the results of the following query
expressions: ` Summaries  `

##  Synopsis  Â¶

    
    
      list-change-sets
    --stack-name <value>
    [--cli-input-json | --cli-input-yaml]
    [--starting-token <value>]
    [--max-items <value>]
    [--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]
    

##  Options  Â¶

` --stack-name  ` (string)

> The name or the Amazon Resource Name (ARN) of the stack for which you want
> to list change sets.

` --cli-input-json  ` | ` --cli-input-yaml  ` (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by ` --generate-cli-skeleton  ` . If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with ` --cli-input-yaml  ` . 

` --starting-token  ` (string)

> A token to specify where to start paginating. This is the ` Next