AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS Documentation » AWS CloudFormation » User Guide » Command Line Tools Reference » cfn-cancel-update-stack
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

cfn-cancel-update-stack

Description

Cancels a stack update that is currently in progress (with state UPDATE_IN_PROGRESS). The stack will be rolled back, reverting the configuration of all resources updated up to that point to their configuration before the update.

Syntax

cfn-cancel-update-stack StackName [--force] [common-options]

Options

StackName | --stack-name stack name | -s stack name

The name or ID of the stack. You can specify the stack name by itself, or preface it with either the --stack or -s switches. Any of these forms is equivalent.

Type: String.

Required: Yes.

Default: none

Example:

$ cfn-cancel-update-stack example-stack
--force

Cancel the stack update without prompting.

Type: Boolean.

Required: No. Default is to prompt before canceling the stack.

Example:

$ cfn-cancel-update-stack example-stack --force

Output

cfn-cancel-update-stack returns no output.

If the command is successful, the stack will be rolled back to its configuration before the update and its state will be set to UPDATE_ROLLBACK_COMPLETE.

Examples

Example Example Request

Cancel a stack update for the stack named example-stack using the long form of the StackName option (this can be useful for clarity, particularly when scripting).

$ cfn-cancel-update-stack --stack-name example-stack

Document Conventions« PreviousNext »
Terms of UseDid this page help you?  Yes | No |  Tell us about it...