amazonka-cloudformation-1.4.5: Amazon CloudFormation SDK.

Copyright(c) 2013-2016 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.CloudFormation.DescribeChangeSet

Contents

Description

Returns the inputs for the change set and a list of changes that AWS CloudFormation will make if you execute the change set. For more information, see Updating Stacks Using Change Sets in the AWS CloudFormation User Guide.

Synopsis

Creating a Request

describeChangeSet #

Creates a value of DescribeChangeSet with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

  • desNextToken - A string (provided by the DescribeChangeSet response output) that identifies the next page of information that you want to retrieve.
  • desStackName - If you specified the name of a change set, specify the stack name or ID (ARN) of the change set you want to describe.
  • desChangeSetName - The name or Amazon Resource Name (ARN) of the change set that you want to describe.

data DescribeChangeSet #

The input for the DescribeChangeSet action.

See: describeChangeSet smart constructor.

Instances

Eq DescribeChangeSet # 
Data DescribeChangeSet # 

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DescribeChangeSet -> c DescribeChangeSet #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DescribeChangeSet #

toConstr :: DescribeChangeSet -> Constr #

dataTypeOf :: DescribeChangeSet -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c DescribeChangeSet) #

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DescribeChangeSet) #

gmapT :: (forall b. Data b => b -> b) -> DescribeChangeSet -> DescribeChangeSet #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DescribeChangeSet -> r #

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DescribeChangeSet -> r #

gmapQ :: (forall d. Data d => d -> u) -> DescribeChangeSet -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> DescribeChangeSet -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> DescribeChangeSet -> m DescribeChangeSet #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeChangeSet -> m DescribeChangeSet #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeChangeSet -> m DescribeChangeSet #

Read DescribeChangeSet # 
Show DescribeChangeSet # 
Generic DescribeChangeSet # 
Hashable DescribeChangeSet # 
NFData DescribeChangeSet # 

Methods

rnf :: DescribeChangeSet -> () #

AWSRequest DescribeChangeSet # 
ToQuery DescribeChangeSet # 
ToPath DescribeChangeSet # 
ToHeaders DescribeChangeSet # 
type Rep DescribeChangeSet # 
type Rep DescribeChangeSet = D1 (MetaData "DescribeChangeSet" "Network.AWS.CloudFormation.DescribeChangeSet" "amazonka-cloudformation-1.4.5-GkPqDOYcHIlLStUFA5eeUs" False) (C1 (MetaCons "DescribeChangeSet'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_desNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_desStackName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_desChangeSetName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))))
type Rs DescribeChangeSet # 

Request Lenses

desNextToken :: Lens' DescribeChangeSet (Maybe Text) #

A string (provided by the DescribeChangeSet response output) that identifies the next page of information that you want to retrieve.

desStackName :: Lens' DescribeChangeSet (Maybe Text) #

If you specified the name of a change set, specify the stack name or ID (ARN) of the change set you want to describe.

desChangeSetName :: Lens' DescribeChangeSet Text #

The name or Amazon Resource Name (ARN) of the change set that you want to describe.

Destructuring the Response

describeChangeSetResponse #

Creates a value of DescribeChangeSetResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

  • drsCreationTime - The start time when the change set was created, in UTC.
  • drsChanges - A list of Change structures that describes the resources AWS CloudFormation changes if you execute the change set.
  • drsNotificationARNs - The ARNs of the Amazon Simple Notification Service (Amazon SNS) topics that will be associated with the stack if you execute the change set.
  • drsChangeSetName - The name of the change set.
  • drsExecutionStatus - If the change set execution status is AVAILABLE , you can execute the change set. If you can’t execute the change set, the status indicates why. For example, a change set might be in an UNAVAILABLE state because AWS CloudFormation is still creating it or in an OBSOLETE state because the stack was already updated.
  • drsChangeSetId - The ARN of the change set.
  • drsNextToken - If the output exceeds 1 MB, a string that identifies the next page of changes. If there is no additional page, this value is null.
  • drsParameters - A list of Parameter structures that describes the input parameters and their values used to create the change set. For more information, see the Parameter data type.
  • drsStatusReason - A description of the change set's status. For example, if your attempt to create a change set failed, AWS CloudFormation shows the error message.
  • drsStackId - The ARN of the stack that is associated with the change set.
  • drsDescription - Information about the change set.
  • drsCapabilities - If you execute the change set, the list of capabilities that were explicitly acknowledged when the change set was created.
  • drsTags - If you execute the change set, the tags that will be associated with the stack.
  • drsStackName - The name of the stack that is associated with the change set.
  • drsResponseStatus - -- | The response status code.
  • drsStatus - The current status of the change set, such as CREATE_IN_PROGRESS , CREATE_COMPLETE , or FAILED .

data DescribeChangeSetResponse #

The output for the DescribeChangeSet action.

See: describeChangeSetResponse smart constructor.

Instances

Eq DescribeChangeSetResponse # 
Data DescribeChangeSetResponse # 

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DescribeChangeSetResponse -> c DescribeChangeSetResponse #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DescribeChangeSetResponse #

toConstr :: DescribeChangeSetResponse -> Constr #

dataTypeOf :: DescribeChangeSetResponse -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c DescribeChangeSetResponse) #

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DescribeChangeSetResponse) #

gmapT :: (forall b. Data b => b -> b) -> DescribeChangeSetResponse -> DescribeChangeSetResponse #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DescribeChangeSetResponse -> r #

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DescribeChangeSetResponse -> r #

gmapQ :: (forall d. Data d => d -> u) -> DescribeChangeSetResponse -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> DescribeChangeSetResponse -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> DescribeChangeSetResponse -> m DescribeChangeSetResponse #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeChangeSetResponse -> m DescribeChangeSetResponse #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeChangeSetResponse -> m DescribeChangeSetResponse #

Read DescribeChangeSetResponse # 
Show DescribeChangeSetResponse # 
Generic DescribeChangeSetResponse # 
NFData DescribeChangeSetResponse # 
type Rep DescribeChangeSetResponse # 
type Rep DescribeChangeSetResponse = D1 (MetaData "DescribeChangeSetResponse" "Network.AWS.CloudFormation.DescribeChangeSet" "amazonka-cloudformation-1.4.5-GkPqDOYcHIlLStUFA5eeUs" False) (C1 (MetaCons "DescribeChangeSetResponse'" PrefixI True) ((:*:) ((:*:) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_drsCreationTime") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe ISO8601))) (S1 (MetaSel (Just Symbol "_drsChanges") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Change])))) ((:*:) (S1 (MetaSel (Just Symbol "_drsNotificationARNs") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Text]))) (S1 (MetaSel (Just Symbol "_drsChangeSetName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_drsExecutionStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe ExecutionStatus))) (S1 (MetaSel (Just Symbol "_drsChangeSetId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) ((:*:) (S1 (MetaSel (Just Symbol "_drsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_drsParameters") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Parameter])))))) ((:*:) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_drsStatusReason") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_drsStackId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) ((:*:) (S1 (MetaSel (Just Symbol "_drsDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_drsCapabilities") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Capability]))))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_drsTags") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Tag]))) (S1 (MetaSel (Just Symbol "_drsStackName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) ((:*:) (S1 (MetaSel (Just Symbol "_drsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 Int)) (S1 (MetaSel (Just Symbol "_drsStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 ChangeSetStatus)))))))

Response Lenses

drsCreationTime :: Lens' DescribeChangeSetResponse (Maybe UTCTime) #

The start time when the change set was created, in UTC.

drsChanges :: Lens' DescribeChangeSetResponse [Change] #

A list of Change structures that describes the resources AWS CloudFormation changes if you execute the change set.

drsNotificationARNs :: Lens' DescribeChangeSetResponse [Text] #

The ARNs of the Amazon Simple Notification Service (Amazon SNS) topics that will be associated with the stack if you execute the change set.

drsExecutionStatus :: Lens' DescribeChangeSetResponse (Maybe ExecutionStatus) #

If the change set execution status is AVAILABLE , you can execute the change set. If you can’t execute the change set, the status indicates why. For example, a change set might be in an UNAVAILABLE state because AWS CloudFormation is still creating it or in an OBSOLETE state because the stack was already updated.

drsChangeSetId :: Lens' DescribeChangeSetResponse (Maybe Text) #

The ARN of the change set.

drsNextToken :: Lens' DescribeChangeSetResponse (Maybe Text) #

If the output exceeds 1 MB, a string that identifies the next page of changes. If there is no additional page, this value is null.

drsParameters :: Lens' DescribeChangeSetResponse [Parameter] #

A list of Parameter structures that describes the input parameters and their values used to create the change set. For more information, see the Parameter data type.

drsStatusReason :: Lens' DescribeChangeSetResponse (Maybe Text) #

A description of the change set's status. For example, if your attempt to create a change set failed, AWS CloudFormation shows the error message.

drsStackId :: Lens' DescribeChangeSetResponse (Maybe Text) #

The ARN of the stack that is associated with the change set.

drsDescription :: Lens' DescribeChangeSetResponse (Maybe Text) #

Information about the change set.

drsCapabilities :: Lens' DescribeChangeSetResponse [Capability] #

If you execute the change set, the list of capabilities that were explicitly acknowledged when the change set was created.

drsTags :: Lens' DescribeChangeSetResponse [Tag] #

If you execute the change set, the tags that will be associated with the stack.

drsStackName :: Lens' DescribeChangeSetResponse (Maybe Text) #

The name of the stack that is associated with the change set.

drsResponseStatus :: Lens' DescribeChangeSetResponse Int #

  • - | The response status code.

drsStatus :: Lens' DescribeChangeSetResponse ChangeSetStatus #

The current status of the change set, such as CREATE_IN_PROGRESS , CREATE_COMPLETE , or FAILED .