Amazonka.CloudFormation.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

Creating a Request

data RollbackStack

See: newRollbackStack smart constructor.

Constructors

RollbackStack'

Fields

• clientRequestToken :: Maybe Text

  A unique identifier for this RollbackStack request.

• roleARN :: Maybe Text

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

• stackName :: Text

  The name that's associated with the stack.

Instances

ToHeaders RollbackStack

Defined in Amazonka.CloudFormation.RollbackStack

Methods

toHeaders :: RollbackStack -> [Header]

ToPath RollbackStack

Defined in Amazonka.CloudFormation.RollbackStack

Methods

toPath :: RollbackStack -> ByteString

ToQuery RollbackStack

Defined in Amazonka.CloudFormation.RollbackStack

Methods

toQuery :: RollbackStack -> QueryString

AWSRequest RollbackStack

Defined in Amazonka.CloudFormation.RollbackStack

Associated Types

type AWSResponse RollbackStack

Methods

request :: (Service -> Service) -> RollbackStack -> Request RollbackStack

response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy RollbackStack -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse RollbackStack)))

Generic RollbackStack

Defined in Amazonka.CloudFormation.RollbackStack

Associated Types

type Rep RollbackStack :: Type -> Type

Methods

from :: RollbackStack -> Rep RollbackStack x

to :: Rep RollbackStack x -> RollbackStack

Read RollbackStack

Defined in Amazonka.CloudFormation.RollbackStack

Methods

readsPrec :: Int -> ReadS RollbackStack

readList :: ReadS [RollbackStack]

readPrec :: ReadPrec RollbackStack

readListPrec :: ReadPrec [RollbackStack]

Show RollbackStack

Defined in Amazonka.CloudFormation.RollbackStack

Methods

showsPrec :: Int -> RollbackStack -> ShowS

show :: RollbackStack -> String

showList :: [RollbackStack] -> ShowS

NFData RollbackStack

Defined in Amazonka.CloudFormation.RollbackStack

Methods

rnf :: RollbackStack -> ()

Eq RollbackStack

Defined in Amazonka.CloudFormation.RollbackStack

Methods

(==) :: RollbackStack -> RollbackStack -> Bool

(/=) :: RollbackStack -> RollbackStack -> Bool

Hashable RollbackStack

Defined in Amazonka.CloudFormation.RollbackStack

Methods

hashWithSalt :: Int -> RollbackStack -> Int

hash :: RollbackStack -> Int

type AWSResponse RollbackStack

Defined in Amazonka.CloudFormation.RollbackStack

type AWSResponse RollbackStack = RollbackStackResponse

type Rep RollbackStack

Defined in Amazonka.CloudFormation.RollbackStack

type Rep RollbackStack = D1 ('MetaData "RollbackStack" "Amazonka.CloudFormation.RollbackStack" "amazonka-cloudformation-2.0-2g2oPzedi5AcwbDRlNZfB" 'False) (C1 ('MetaCons "RollbackStack'" 'PrefixI 'True) (S1 ('MetaSel ('Just "clientRequestToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "roleARN") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "stackName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))

newRollbackStack

Arguments

:: Text

RollbackStack

-> RollbackStack

Create a value of RollbackStack with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

RollbackStack, rollbackStack_clientRequestToken - A unique identifier for this RollbackStack request.

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

RollbackStack, rollbackStack_stackName - The name that's associated with the stack.

Request Lenses

rollbackStack_clientRequestToken :: Lens' RollbackStack (Maybe Text)

A unique identifier for this RollbackStack request.

rollbackStack_roleARN :: Lens' RollbackStack (Maybe Text)

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

rollbackStack_stackName :: Lens' RollbackStack Text

The name that's associated with the stack.

Destructuring the Response

data RollbackStackResponse

See: newRollbackStackResponse smart constructor.

Constructors

RollbackStackResponse'

Fields

• stackId :: Maybe Text

  Unique identifier of the stack.

• httpStatus :: Int

  The response's http status code.

Instances

Generic RollbackStackResponse

Defined in Amazonka.CloudFormation.RollbackStack

Associated Types

type Rep RollbackStackResponse :: Type -> Type

Methods

from :: RollbackStackResponse -> Rep RollbackStackResponse x

to :: Rep RollbackStackResponse x -> RollbackStackResponse

Read RollbackStackResponse

Defined in Amazonka.CloudFormation.RollbackStack

Methods

readsPrec :: Int -> ReadS RollbackStackResponse

readList :: ReadS [RollbackStackResponse]

readPrec :: ReadPrec RollbackStackResponse

readListPrec :: ReadPrec [RollbackStackResponse]

Show RollbackStackResponse

Defined in Amazonka.CloudFormation.RollbackStack

Methods

showsPrec :: Int -> RollbackStackResponse -> ShowS

show :: RollbackStackResponse -> String

showList :: [RollbackStackResponse] -> ShowS

NFData RollbackStackResponse

Defined in Amazonka.CloudFormation.RollbackStack

Methods

rnf :: RollbackStackResponse -> ()

Eq RollbackStackResponse

Defined in Amazonka.CloudFormation.RollbackStack

Methods

(==) :: RollbackStackResponse -> RollbackStackResponse -> Bool

(/=) :: RollbackStackResponse -> RollbackStackResponse -> Bool

type Rep RollbackStackResponse

Defined in Amazonka.CloudFormation.RollbackStack

type Rep RollbackStackResponse = D1 ('MetaData "RollbackStackResponse" "Amazonka.CloudFormation.RollbackStack" "amazonka-cloudformation-2.0-2g2oPzedi5AcwbDRlNZfB" 'False) (C1 ('MetaCons "RollbackStackResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "stackId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newRollbackStackResponse

Arguments

:: Int

$sel:httpStatus:RollbackStackResponse'

-> RollbackStackResponse

Create a value of RollbackStackResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

RollbackStackResponse, rollbackStackResponse_stackId - Unique identifier of the stack.

$sel:httpStatus:RollbackStackResponse', rollbackStackResponse_httpStatus - The response's http status code.

Response Lenses

rollbackStackResponse_stackId :: Lens' RollbackStackResponse (Maybe Text)

Unique identifier of the stack.

rollbackStackResponse_httpStatus :: Lens' RollbackStackResponse Int

The response's http status code.