[ 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 ](set-stack-policy.html "set-stack-policy") | 
  * [ previous ](register-type.html "register-type") | 
  * [ AWS CLI 2.15.40 Command Reference ](../../index.html) » 
  * [ aws ](../index.html) » 
  * [ cloudformation ](index.html) » 

  * [ ← register-type ](register-type.html "previous chapter \(use the left arrow\)") / 
  * [ set-stack-policy → ](set-stack-policy.html "next chapter \(use the right arrow\)")

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

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

  * rollback-stack 
    * Description 
    * Synopsis 
    * Options 
    * Global Options 
    * 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/rollback-
stack.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) ]

#  rollback-stack  Â¶

##  Description  Â¶

When specifying ` RollbackStack  ` , you preserve the state of previously
provisioned resources when an operation fails. You can check the status of the
stack through the DescribeStacks operation.

Rolls back the specified stack to the last known stable state from `
CREATE_FAILED  ` or ` UPDATE_FAILED  ` stack statuses.

This operation will delete a stack if it doesnât contain a last known stable
state. A last known stable state includes any status in a ` *_COMPLETE  ` .
This includes the following stack statuses.

  * ` CREATE_COMPLETE  `
  * ` UPDATE_COMPLETE  `
  * ` UPDATE_ROLLBACK_COMPLETE  `
  * ` IMPORT_COMPLETE  `
  * ` IMPORT_ROLLBACK_COMPLETE  `

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

##  Synopsis  Â¶

    
    
      rollback-stack
    --stack-name <value>
    [--role-arn <value>]
    [--client-request-token <value>]
    [--retain-except-on-create | --no-retain-except-on-create]
    [--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]
    

##  Options  Â¶

` --stack-name  ` (string)

> The name thatâs associated with the stack.

` --role-arn  ` (string)

> The Amazon Resource Name (ARN) of an Identity and Access Management role
> that CloudFormation assumes to rollback the stack.

` --client-request-token  ` (string)

> A unique identifier for this ` RollbackStack  ` request.

` --retain-except-on-create  ` | ` --no-retain-except-on-create  ` (boolean) 

> When set to ` true  ` , newly created resources are deleted when the
> operation rolls back. This includes newly created resources marked with a
> deletion policy of ` Retain  ` .
>
> Default: ` f