RollbackStack
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
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
- ClientRequestToken
-
A unique identifier for this
RollbackStack
request.Type: String
Length Constraints: Minimum length of 1. Maximum length of 128.
Pattern:
[a-zA-Z0-9][-a-zA-Z0-9]*
Required: No
- RoleARN
-
The Amazon Resource Name (ARN) of an AWS Identity and Access Management role that AWS CloudFormation assumes to rollback the stack.
Type: String
Length Constraints: Minimum length of 20. Maximum length of 2048.
Required: No
- StackName
-
The name that's associated with the stack.
Type: String
Length Constraints: Minimum length of 1.
Pattern:
([a-zA-Z][-a-zA-Z0-9]*)|(arn:\b(aws|aws-us-gov|aws-cn)\b:[-a-zA-Z0-9:/._+]*)
Required: Yes
Response Elements
The following element is returned by the service.
- StackId
-
Unique identifier of the stack.
Type: String
Errors
For information about the errors that are common to all actions, see Common Errors.
- TokenAlreadyExists
-
A client request token already exists.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: