amazonka-cloudformation 1.4.4 → 1.4.5
raw patch · 38 files changed
+1339/−753 lines, 38 filesdep ~amazonka-cloudformationdep ~amazonka-coredep ~amazonka-testPVP: major bump suggested
API removals or changes: PVP suggests a major version bump
Dependency ranges changed: amazonka-cloudformation, amazonka-core, amazonka-test
API changes (from Hackage documentation)
+ Network.AWS.CloudFormation: Create :: ChangeSetType
+ Network.AWS.CloudFormation: Original :: TemplateStage
+ Network.AWS.CloudFormation: Processed :: TemplateStage
+ Network.AWS.CloudFormation: SSReviewInProgress :: StackStatus
+ Network.AWS.CloudFormation: Update :: ChangeSetType
+ Network.AWS.CloudFormation: changeSetCreateComplete :: Wait DescribeChangeSet
+ Network.AWS.CloudFormation: data ChangeSetType
+ Network.AWS.CloudFormation: data Export
+ Network.AWS.CloudFormation: data TemplateStage
+ Network.AWS.CloudFormation: eExportingStackId :: Lens' Export (Maybe Text)
+ Network.AWS.CloudFormation: eName :: Lens' Export (Maybe Text)
+ Network.AWS.CloudFormation: eValue :: Lens' Export (Maybe Text)
+ Network.AWS.CloudFormation: export' :: Export
+ Network.AWS.CloudFormation: sChangeSetId :: Lens' Stack (Maybe Text)
+ Network.AWS.CloudFormation: sRoleARN :: Lens' Stack (Maybe Text)
+ Network.AWS.CloudFormation.ContinueUpdateRollback: curResourcesToSkip :: Lens' ContinueUpdateRollback [Text]
+ Network.AWS.CloudFormation.ContinueUpdateRollback: curRoleARN :: Lens' ContinueUpdateRollback (Maybe Text)
+ Network.AWS.CloudFormation.CreateChangeSet: ccsChangeSetType :: Lens' CreateChangeSet (Maybe ChangeSetType)
+ Network.AWS.CloudFormation.CreateChangeSet: ccsRoleARN :: Lens' CreateChangeSet (Maybe Text)
+ Network.AWS.CloudFormation.CreateChangeSet: ccsrsStackId :: Lens' CreateChangeSetResponse (Maybe Text)
+ Network.AWS.CloudFormation.CreateStack: csRoleARN :: Lens' CreateStack (Maybe Text)
+ Network.AWS.CloudFormation.DeleteStack: dsRoleARN :: Lens' DeleteStack (Maybe Text)
+ Network.AWS.CloudFormation.GetTemplate: gtChangeSetName :: Lens' GetTemplate (Maybe Text)
+ Network.AWS.CloudFormation.GetTemplate: gtTemplateStage :: Lens' GetTemplate (Maybe TemplateStage)
+ Network.AWS.CloudFormation.GetTemplate: gtrsStagesAvailable :: Lens' GetTemplateResponse [TemplateStage]
+ Network.AWS.CloudFormation.GetTemplateSummary: gtsrsDeclaredTransforms :: Lens' GetTemplateSummaryResponse [Text]
+ Network.AWS.CloudFormation.ListExports: data ListExports
+ Network.AWS.CloudFormation.ListExports: data ListExportsResponse
+ Network.AWS.CloudFormation.ListExports: instance Control.DeepSeq.NFData Network.AWS.CloudFormation.ListExports.ListExports
+ Network.AWS.CloudFormation.ListExports: instance Control.DeepSeq.NFData Network.AWS.CloudFormation.ListExports.ListExportsResponse
+ Network.AWS.CloudFormation.ListExports: instance Data.Data.Data Network.AWS.CloudFormation.ListExports.ListExports
+ Network.AWS.CloudFormation.ListExports: instance Data.Data.Data Network.AWS.CloudFormation.ListExports.ListExportsResponse
+ Network.AWS.CloudFormation.ListExports: instance Data.Hashable.Class.Hashable Network.AWS.CloudFormation.ListExports.ListExports
+ Network.AWS.CloudFormation.ListExports: instance GHC.Classes.Eq Network.AWS.CloudFormation.ListExports.ListExports
+ Network.AWS.CloudFormation.ListExports: instance GHC.Classes.Eq Network.AWS.CloudFormation.ListExports.ListExportsResponse
+ Network.AWS.CloudFormation.ListExports: instance GHC.Generics.Generic Network.AWS.CloudFormation.ListExports.ListExports
+ Network.AWS.CloudFormation.ListExports: instance GHC.Generics.Generic Network.AWS.CloudFormation.ListExports.ListExportsResponse
+ Network.AWS.CloudFormation.ListExports: instance GHC.Read.Read Network.AWS.CloudFormation.ListExports.ListExports
+ Network.AWS.CloudFormation.ListExports: instance GHC.Read.Read Network.AWS.CloudFormation.ListExports.ListExportsResponse
+ Network.AWS.CloudFormation.ListExports: instance GHC.Show.Show Network.AWS.CloudFormation.ListExports.ListExports
+ Network.AWS.CloudFormation.ListExports: instance GHC.Show.Show Network.AWS.CloudFormation.ListExports.ListExportsResponse
+ Network.AWS.CloudFormation.ListExports: instance Network.AWS.Data.Headers.ToHeaders Network.AWS.CloudFormation.ListExports.ListExports
+ Network.AWS.CloudFormation.ListExports: instance Network.AWS.Data.Path.ToPath Network.AWS.CloudFormation.ListExports.ListExports
+ Network.AWS.CloudFormation.ListExports: instance Network.AWS.Data.Query.ToQuery Network.AWS.CloudFormation.ListExports.ListExports
+ Network.AWS.CloudFormation.ListExports: instance Network.AWS.Types.AWSRequest Network.AWS.CloudFormation.ListExports.ListExports
+ Network.AWS.CloudFormation.ListExports: leNextToken :: Lens' ListExports (Maybe Text)
+ Network.AWS.CloudFormation.ListExports: lersExports :: Lens' ListExportsResponse [Export]
+ Network.AWS.CloudFormation.ListExports: lersNextToken :: Lens' ListExportsResponse (Maybe Text)
+ Network.AWS.CloudFormation.ListExports: lersResponseStatus :: Lens' ListExportsResponse Int
+ Network.AWS.CloudFormation.ListExports: listExports :: ListExports
+ Network.AWS.CloudFormation.ListExports: listExportsResponse :: Int -> ListExportsResponse
+ Network.AWS.CloudFormation.ListImports: data ListImports
+ Network.AWS.CloudFormation.ListImports: data ListImportsResponse
+ Network.AWS.CloudFormation.ListImports: instance Control.DeepSeq.NFData Network.AWS.CloudFormation.ListImports.ListImports
+ Network.AWS.CloudFormation.ListImports: instance Control.DeepSeq.NFData Network.AWS.CloudFormation.ListImports.ListImportsResponse
+ Network.AWS.CloudFormation.ListImports: instance Data.Data.Data Network.AWS.CloudFormation.ListImports.ListImports
+ Network.AWS.CloudFormation.ListImports: instance Data.Data.Data Network.AWS.CloudFormation.ListImports.ListImportsResponse
+ Network.AWS.CloudFormation.ListImports: instance Data.Hashable.Class.Hashable Network.AWS.CloudFormation.ListImports.ListImports
+ Network.AWS.CloudFormation.ListImports: instance GHC.Classes.Eq Network.AWS.CloudFormation.ListImports.ListImports
+ Network.AWS.CloudFormation.ListImports: instance GHC.Classes.Eq Network.AWS.CloudFormation.ListImports.ListImportsResponse
+ Network.AWS.CloudFormation.ListImports: instance GHC.Generics.Generic Network.AWS.CloudFormation.ListImports.ListImports
+ Network.AWS.CloudFormation.ListImports: instance GHC.Generics.Generic Network.AWS.CloudFormation.ListImports.ListImportsResponse
+ Network.AWS.CloudFormation.ListImports: instance GHC.Read.Read Network.AWS.CloudFormation.ListImports.ListImports
+ Network.AWS.CloudFormation.ListImports: instance GHC.Read.Read Network.AWS.CloudFormation.ListImports.ListImportsResponse
+ Network.AWS.CloudFormation.ListImports: instance GHC.Show.Show Network.AWS.CloudFormation.ListImports.ListImports
+ Network.AWS.CloudFormation.ListImports: instance GHC.Show.Show Network.AWS.CloudFormation.ListImports.ListImportsResponse
+ Network.AWS.CloudFormation.ListImports: instance Network.AWS.Data.Headers.ToHeaders Network.AWS.CloudFormation.ListImports.ListImports
+ Network.AWS.CloudFormation.ListImports: instance Network.AWS.Data.Path.ToPath Network.AWS.CloudFormation.ListImports.ListImports
+ Network.AWS.CloudFormation.ListImports: instance Network.AWS.Data.Query.ToQuery Network.AWS.CloudFormation.ListImports.ListImports
+ Network.AWS.CloudFormation.ListImports: instance Network.AWS.Types.AWSRequest Network.AWS.CloudFormation.ListImports.ListImports
+ Network.AWS.CloudFormation.ListImports: liExportName :: Lens' ListImports Text
+ Network.AWS.CloudFormation.ListImports: liNextToken :: Lens' ListImports (Maybe Text)
+ Network.AWS.CloudFormation.ListImports: lirsImports :: Lens' ListImportsResponse [Text]
+ Network.AWS.CloudFormation.ListImports: lirsNextToken :: Lens' ListImportsResponse (Maybe Text)
+ Network.AWS.CloudFormation.ListImports: lirsResponseStatus :: Lens' ListImportsResponse Int
+ Network.AWS.CloudFormation.ListImports: listImports :: Text -> ListImports
+ Network.AWS.CloudFormation.ListImports: listImportsResponse :: Int -> ListImportsResponse
+ Network.AWS.CloudFormation.Types: Create :: ChangeSetType
+ Network.AWS.CloudFormation.Types: Original :: TemplateStage
+ Network.AWS.CloudFormation.Types: Processed :: TemplateStage
+ Network.AWS.CloudFormation.Types: SSReviewInProgress :: StackStatus
+ Network.AWS.CloudFormation.Types: Update :: ChangeSetType
+ Network.AWS.CloudFormation.Types: data ChangeSetType
+ Network.AWS.CloudFormation.Types: data Export
+ Network.AWS.CloudFormation.Types: data TemplateStage
+ Network.AWS.CloudFormation.Types: eExportingStackId :: Lens' Export (Maybe Text)
+ Network.AWS.CloudFormation.Types: eName :: Lens' Export (Maybe Text)
+ Network.AWS.CloudFormation.Types: eValue :: Lens' Export (Maybe Text)
+ Network.AWS.CloudFormation.Types: export' :: Export
+ Network.AWS.CloudFormation.Types: sChangeSetId :: Lens' Stack (Maybe Text)
+ Network.AWS.CloudFormation.Types: sRoleARN :: Lens' Stack (Maybe Text)
+ Network.AWS.CloudFormation.UpdateStack: usRoleARN :: Lens' UpdateStack (Maybe Text)
+ Network.AWS.CloudFormation.ValidateTemplate: vtrsDeclaredTransforms :: Lens' ValidateTemplateResponse [Text]
+ Network.AWS.CloudFormation.Waiters: changeSetCreateComplete :: Wait DescribeChangeSet
- Network.AWS.CloudFormation.DescribeChangeSet: describeChangeSetResponse :: Int -> DescribeChangeSetResponse
+ Network.AWS.CloudFormation.DescribeChangeSet: describeChangeSetResponse :: Int -> ChangeSetStatus -> DescribeChangeSetResponse
- Network.AWS.CloudFormation.DescribeChangeSet: drsStatus :: Lens' DescribeChangeSetResponse (Maybe ChangeSetStatus)
+ Network.AWS.CloudFormation.DescribeChangeSet: drsStatus :: Lens' DescribeChangeSetResponse ChangeSetStatus
- Network.AWS.CloudFormation.GetTemplate: getTemplate :: Text -> GetTemplate
+ Network.AWS.CloudFormation.GetTemplate: getTemplate :: GetTemplate
- Network.AWS.CloudFormation.GetTemplate: gtStackName :: Lens' GetTemplate Text
+ Network.AWS.CloudFormation.GetTemplate: gtStackName :: Lens' GetTemplate (Maybe Text)
Files
- README.md +9/−14
- amazonka-cloudformation.cabal +12/−19
- fixture/ListExports.yaml +0/−0
- fixture/ListExportsResponse.proto +0/−0
- fixture/ListImports.yaml +0/−0
- fixture/ListImportsResponse.proto +0/−0
- gen/Network/AWS/CloudFormation.hs +31/−4
- gen/Network/AWS/CloudFormation/CancelUpdateStack.hs +5/−3
- gen/Network/AWS/CloudFormation/ContinueUpdateRollback.hs +38/−10
- gen/Network/AWS/CloudFormation/CreateChangeSet.hs +67/−45
- gen/Network/AWS/CloudFormation/CreateStack.hs +45/−48
- gen/Network/AWS/CloudFormation/DeleteChangeSet.hs +12/−6
- gen/Network/AWS/CloudFormation/DeleteStack.hs +19/−8
- gen/Network/AWS/CloudFormation/DescribeAccountLimits.hs +14/−8
- gen/Network/AWS/CloudFormation/DescribeChangeSet.hs +45/−37
- gen/Network/AWS/CloudFormation/DescribeStackEvents.hs +16/−18
- gen/Network/AWS/CloudFormation/DescribeStackResource.hs +16/−18
- gen/Network/AWS/CloudFormation/DescribeStackResources.hs +19/−33
- gen/Network/AWS/CloudFormation/DescribeStacks.hs +15/−15
- gen/Network/AWS/CloudFormation/EstimateTemplateCost.hs +17/−15
- gen/Network/AWS/CloudFormation/ExecuteChangeSet.hs +15/−9
- gen/Network/AWS/CloudFormation/GetStackPolicy.hs +13/−7
- gen/Network/AWS/CloudFormation/GetTemplate.hs +55/−26
- gen/Network/AWS/CloudFormation/GetTemplateSummary.hs +46/−36
- gen/Network/AWS/CloudFormation/ListChangeSets.hs +17/−11
- gen/Network/AWS/CloudFormation/ListExports.hs +138/−0
- gen/Network/AWS/CloudFormation/ListImports.hs +149/−0
- gen/Network/AWS/CloudFormation/ListStackResources.hs +16/−16
- gen/Network/AWS/CloudFormation/ListStacks.hs +16/−10
- gen/Network/AWS/CloudFormation/SetStackPolicy.hs +10/−6
- gen/Network/AWS/CloudFormation/SignalResource.hs +10/−6
- gen/Network/AWS/CloudFormation/Types.hs +28/−3
- gen/Network/AWS/CloudFormation/Types/Product.hs +248/−167
- gen/Network/AWS/CloudFormation/Types/Sum.hs +53/−1
- gen/Network/AWS/CloudFormation/UpdateStack.hs +47/−54
- gen/Network/AWS/CloudFormation/ValidateTemplate.hs +37/−25
- gen/Network/AWS/CloudFormation/Waiters.hs +25/−75
- test/Test/AWS/Gen/CloudFormation.hs +36/−0
README.md view
@@ -8,32 +8,27 @@ ## Version -`1.4.4`+`1.4.5` ## Description -AWS CloudFormation--AWS CloudFormation enables you to create and manage AWS infrastructure deployments predictably and repeatedly. AWS CloudFormation helps you leverage AWS products such as Amazon EC2, EBS, Amazon SNS, ELB, and Auto Scaling to build highly-reliable, highly scalable, cost effective applications without worrying about creating and configuring the underlying AWS infrastructure.--With AWS CloudFormation, you declare all of your resources and dependencies in a template file. The template defines a collection of resources as a single unit called a stack. AWS CloudFormation creates and deletes all member resources of the stack together and manages all dependencies between the resources for you.--For more information about this product, go to the <http://aws.amazon.com/cloudformation/ CloudFormation Product Page>.--Amazon CloudFormation makes use of other AWS products. If you need additional technical information about a specific AWS product, you can find the product\'s technical documentation at <http://docs.aws.amazon.com/>.- Documentation is available via [Hackage](http://hackage.haskell.org/package/amazonka-cloudformation) and the [AWS API Reference](https://aws.amazon.com/documentation/). The types from this library are intended to be used with [amazonka](http://hackage.haskell.org/package/amazonka),-which provides mechanisms for specifying AuthN/AuthZ information and sending requests.+which provides mechanisms for specifying AuthN/AuthZ information, sending requests,+and receiving responses. -Use of lenses is required for constructing and manipulating types.-This is due to the amount of nesting of AWS types and transparency regarding+Lenses are used for constructing and manipulating types,+due to the depth of nesting of AWS types and transparency regarding de/serialisation into more palatable Haskell values. The provided lenses should be compatible with any of the major lens libraries [lens](http://hackage.haskell.org/package/lens) or [lens-family-core](http://hackage.haskell.org/package/lens-family-core).++See [Network.AWS.CloudFormation](http://hackage.haskell.org/package/amazonka-cloudformation/docs/Network-AWS-CloudFormation.html)+or [the AWS documentation](https://aws.amazon.com/documentation/) to get started.+ ## Contribute
amazonka-cloudformation.cabal view
@@ -1,5 +1,5 @@ name: amazonka-cloudformation-version: 1.4.4+version: 1.4.5 synopsis: Amazon CloudFormation SDK. homepage: https://github.com/brendanhay/amazonka bug-reports: https://github.com/brendanhay/amazonka/issues@@ -13,28 +13,19 @@ cabal-version: >= 1.10 extra-source-files: README.md fixture/*.yaml fixture/*.proto src/.gitkeep description:- AWS CloudFormation-- AWS CloudFormation enables you to create and manage AWS infrastructure deployments predictably and repeatedly. AWS CloudFormation helps you leverage AWS products such as Amazon EC2, EBS, Amazon SNS, ELB, and Auto Scaling to build highly-reliable, highly scalable, cost effective applications without worrying about creating and configuring the underlying AWS infrastructure.-- With AWS CloudFormation, you declare all of your resources and dependencies in a template file. The template defines a collection of resources as a single unit called a stack. AWS CloudFormation creates and deletes all member resources of the stack together and manages all dependencies between the resources for you.-- For more information about this product, go to the <http://aws.amazon.com/cloudformation/ CloudFormation Product Page>.-- Amazon CloudFormation makes use of other AWS products. If you need additional technical information about a specific AWS product, you can find the product\'s technical documentation at <http://docs.aws.amazon.com/>.- . The types from this library are intended to be used with <http://hackage.haskell.org/package/amazonka amazonka>, which provides- mechanisms for specifying AuthN/AuthZ information and sending requests.+ mechanisms for specifying AuthN/AuthZ information, sending requests,+ and receiving responses. .- Use of lenses is required for constructing and manipulating types.- This is due to the amount of nesting of AWS types and transparency regarding+ Lenses are used for constructing and manipulating types,+ due to the depth of nesting of AWS types and transparency regarding de/serialisation into more palatable Haskell values. The provided lenses should be compatible with any of the major lens libraries such as <http://hackage.haskell.org/package/lens lens> or <http://hackage.haskell.org/package/lens-family-core lens-family-core>. .- See "Network.AWS.CloudFormation" or <https://aws.amazon.com/documentation/ the AWS Documentation>+ See "Network.AWS.CloudFormation" or <https://aws.amazon.com/documentation/ the AWS documentation> to get started. source-repository head@@ -67,6 +58,8 @@ , Network.AWS.CloudFormation.GetTemplate , Network.AWS.CloudFormation.GetTemplateSummary , Network.AWS.CloudFormation.ListChangeSets+ , Network.AWS.CloudFormation.ListExports+ , Network.AWS.CloudFormation.ListImports , Network.AWS.CloudFormation.ListStackResources , Network.AWS.CloudFormation.ListStacks , Network.AWS.CloudFormation.SetStackPolicy@@ -81,7 +74,7 @@ , Network.AWS.CloudFormation.Types.Sum build-depends:- amazonka-core == 1.4.4.*+ amazonka-core == 1.4.5.* , base >= 4.7 && < 5 test-suite amazonka-cloudformation-test@@ -101,9 +94,9 @@ , Test.AWS.CloudFormation.Internal build-depends:- amazonka-core == 1.4.4.*- , amazonka-test == 1.4.4.*- , amazonka-cloudformation == 1.4.4.*+ amazonka-core == 1.4.5.*+ , amazonka-test == 1.4.5.*+ , amazonka-cloudformation == 1.4.5.* , base , bytestring , tasty
+ fixture/ListExports.yaml view
+ fixture/ListExportsResponse.proto view
+ fixture/ListImports.yaml view
+ fixture/ListImportsResponse.proto view
gen/Network/AWS/CloudFormation.hs view
@@ -11,15 +11,16 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- AWS CloudFormation+-- __AWS CloudFormation__ ----- AWS CloudFormation enables you to create and manage AWS infrastructure deployments predictably and repeatedly. AWS CloudFormation helps you leverage AWS products such as Amazon EC2, EBS, Amazon SNS, ELB, and Auto Scaling to build highly-reliable, highly scalable, cost effective applications without worrying about creating and configuring the underlying AWS infrastructure.+-- AWS CloudFormation allows you to create and manage AWS infrastructure deployments predictably and repeatedly. You can use AWS CloudFormation to leverage AWS products, such as Amazon Elastic Compute Cloud, Amazon Elastic Block Store, Amazon Simple Notification Service, Elastic Load Balancing, and Auto Scaling to build highly-reliable, highly scalable, cost-effective applications without creating or configuring the underlying AWS infrastructure. -- -- With AWS CloudFormation, you declare all of your resources and dependencies in a template file. The template defines a collection of resources as a single unit called a stack. AWS CloudFormation creates and deletes all member resources of the stack together and manages all dependencies between the resources for you. ----- For more information about this product, go to the <http://aws.amazon.com/cloudformation/ CloudFormation Product Page>.+-- For more information about AWS CloudFormation, see the <http://aws.amazon.com/cloudformation/ AWS CloudFormation Product Page> . ----- Amazon CloudFormation makes use of other AWS products. If you need additional technical information about a specific AWS product, you can find the product\'s technical documentation at <http://docs.aws.amazon.com/>.+-- Amazon CloudFormation makes use of other AWS products. If you need additional technical information about a specific AWS product, you can find the product's technical documentation at <http://docs.aws.amazon.com/http:/docs.aws.amazon.com/ http://docs.aws.amazon.com/> .+-- module Network.AWS.CloudFormation ( -- * Service Configuration@@ -58,6 +59,9 @@ -- ** StackDeleteComplete , stackDeleteComplete + -- ** ChangeSetCreateComplete+ , changeSetCreateComplete+ -- * Operations -- $operations @@ -106,6 +110,9 @@ -- ** SetStackPolicy , module Network.AWS.CloudFormation.SetStackPolicy + -- ** ListImports+ , module Network.AWS.CloudFormation.ListImports+ -- ** ListStacks (Paginated) , module Network.AWS.CloudFormation.ListStacks @@ -124,6 +131,9 @@ -- ** DeleteChangeSet , module Network.AWS.CloudFormation.DeleteChangeSet + -- ** ListExports+ , module Network.AWS.CloudFormation.ListExports+ -- ** GetTemplate , module Network.AWS.CloudFormation.GetTemplate @@ -144,6 +154,9 @@ -- ** ChangeSetStatus , ChangeSetStatus (..) + -- ** ChangeSetType+ , ChangeSetType (..)+ -- ** ChangeSource , ChangeSource (..) @@ -177,6 +190,9 @@ -- ** StackStatus , StackStatus (..) + -- ** TemplateStage+ , TemplateStage (..)+ -- ** AccountLimit , AccountLimit , accountLimit@@ -202,6 +218,13 @@ , cssDescription , cssStackName + -- ** Export+ , Export+ , export'+ , eValue+ , eExportingStackId+ , eName+ -- ** Output , Output , output@@ -264,6 +287,7 @@ , sLastUpdatedTime , sNotificationARNs , sStackStatusReason+ , sChangeSetId , sOutputs , sParameters , sStackId@@ -271,6 +295,7 @@ , sCapabilities , sTags , sTimeoutInMinutes+ , sRoleARN , sStackName , sCreationTime , sStackStatus@@ -371,6 +396,8 @@ import Network.AWS.CloudFormation.GetTemplate import Network.AWS.CloudFormation.GetTemplateSummary import Network.AWS.CloudFormation.ListChangeSets+import Network.AWS.CloudFormation.ListExports+import Network.AWS.CloudFormation.ListImports import Network.AWS.CloudFormation.ListStackResources import Network.AWS.CloudFormation.ListStacks import Network.AWS.CloudFormation.SetStackPolicy
gen/Network/AWS/CloudFormation/CancelUpdateStack.hs view
@@ -20,7 +20,7 @@ -- -- Cancels an update on the specified stack. If the call completes successfully, the stack rolls back the update and reverts to the previous stack configuration. ----- You can cancel only stacks that are in the UPDATE_IN_PROGRESS state.+-- module Network.AWS.CloudFormation.CancelUpdateStack ( -- * Creating a Request@@ -41,8 +41,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for the < CancelUpdateStack> action.+-- | The input for the 'CancelUpdateStack' action. --+--+-- -- /See:/ 'cancelUpdateStack' smart constructor. newtype CancelUpdateStack = CancelUpdateStack' { _cusStackName :: Text@@ -52,7 +54,7 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'cusStackName'+-- * 'cusStackName' - The name or the unique stack ID that is associated with the stack. cancelUpdateStack :: Text -- ^ 'cusStackName' -> CancelUpdateStack
gen/Network/AWS/CloudFormation/ContinueUpdateRollback.hs view
@@ -18,15 +18,19 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- For a specified stack that is in the 'UPDATE_ROLLBACK_FAILED' state, continues rolling it back to the 'UPDATE_ROLLBACK_COMPLETE' state. Depending on the cause of the failure, you can manually <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed fix the error> and continue the rollback. By continuing the rollback, you can return your stack to a working state (the 'UPDATE_ROLLBACK_COMPLETE' state), and then try to update the stack again.+-- For a specified stack that is in the @UPDATE_ROLLBACK_FAILED@ state, continues rolling it back to the @UPDATE_ROLLBACK_COMPLETE@ state. Depending on the cause of the failure, you can manually <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed fix the error> and continue the rollback. By continuing the rollback, you can return your stack to a working state (the @UPDATE_ROLLBACK_COMPLETE@ state), and then try to update the stack again. ----- A stack goes into the 'UPDATE_ROLLBACK_FAILED' state when AWS CloudFormation cannot roll back all changes after a failed stack update. For example, you might have a stack that is rolling back to an old database instance that was deleted outside of AWS CloudFormation. Because AWS CloudFormation doesn\'t know the database was deleted, it assumes that the database instance still exists and attempts to roll back to it, causing the update rollback to fail.+--+-- A stack goes into the @UPDATE_ROLLBACK_FAILED@ state when AWS CloudFormation cannot roll back all changes after a failed stack update. For example, you might have a stack that is rolling back to an old database instance that was deleted outside of AWS CloudFormation. Because AWS CloudFormation doesn't know the database was deleted, it assumes that the database instance still exists and attempts to roll back to it, causing the update rollback to fail.+-- module Network.AWS.CloudFormation.ContinueUpdateRollback ( -- * Creating a Request continueUpdateRollback , ContinueUpdateRollback -- * Request Lenses+ , curResourcesToSkip+ , curRoleARN , curStackName -- * Destructuring the Response@@ -43,26 +47,44 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for the < ContinueUpdateRollback> action.+-- | The input for the 'ContinueUpdateRollback' action. --+--+-- -- /See:/ 'continueUpdateRollback' smart constructor.-newtype ContinueUpdateRollback = ContinueUpdateRollback'- { _curStackName :: Text+data ContinueUpdateRollback = ContinueUpdateRollback'+ { _curResourcesToSkip :: !(Maybe [Text])+ , _curRoleARN :: !(Maybe Text)+ , _curStackName :: !Text } deriving (Eq,Read,Show,Data,Typeable,Generic) -- | Creates a value of 'ContinueUpdateRollback' with the minimum fields required to make a request. -- -- Use one of the following lenses to modify other fields as desired: ----- * 'curStackName'+-- * 'curResourcesToSkip' - A list of the logical IDs of the resources that AWS CloudFormation skips during the continue update rollback operation. You can specify only resources that are in the @UPDATE_FAILED@ state because a rollback failed. You can't specify resources that are in the @UPDATE_FAILED@ state for other reasons, for example, because an update was canceled. To check why a resource update failed, use the 'DescribeStackResources' action, and view the resource status reason. /Important:/ Specify this property to skip rolling back resources that AWS CloudFormation can't successfully roll back. We recommend that you <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed troubleshoot> resources before skipping them. AWS CloudFormation sets the status of the specified resources to @UPDATE_COMPLETE@ and continues to roll back the stack. After the rollback is complete, the state of the skipped resources will be inconsistent with the state of the resources in the stack template. Before performing another stack update, you must update the stack or resources to be consistent with each other. If you don't, subsequent stack updates might fail, and the stack will become unrecoverable. Specify the minimum number of resources required to successfully roll back your stack. For example, a failed resource update might cause dependent resources to fail. In this case, it might not be necessary to skip the dependent resources. To specify resources in a nested stack, use the following format: @NestedStackName.ResourceLogicalID@ . You can specify a nested stack resource (the logical ID of an @AWS::CloudFormation::Stack@ resource) only if it's in one of the following states: @DELETE_IN_PROGRESS@ , @DELETE_COMPLETE@ , or @DELETE_FAILED@ .+--+-- * 'curRoleARN' - The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes to roll back the stack. AWS CloudFormation uses the role's credentials to make calls on your behalf. AWS CloudFormation always uses this role for all future operations on the stack. As long as users have permission to operate on the stack, AWS CloudFormation uses this role even if the users don't have permission to pass it. Ensure that the role grants least privilege. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.+--+-- * 'curStackName' - The name or the unique ID of the stack that you want to continue rolling back. continueUpdateRollback :: Text -- ^ 'curStackName' -> ContinueUpdateRollback continueUpdateRollback pStackName_ = ContinueUpdateRollback'- { _curStackName = pStackName_+ { _curResourcesToSkip = Nothing+ , _curRoleARN = Nothing+ , _curStackName = pStackName_ } +-- | A list of the logical IDs of the resources that AWS CloudFormation skips during the continue update rollback operation. You can specify only resources that are in the @UPDATE_FAILED@ state because a rollback failed. You can't specify resources that are in the @UPDATE_FAILED@ state for other reasons, for example, because an update was canceled. To check why a resource update failed, use the 'DescribeStackResources' action, and view the resource status reason. /Important:/ Specify this property to skip rolling back resources that AWS CloudFormation can't successfully roll back. We recommend that you <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed troubleshoot> resources before skipping them. AWS CloudFormation sets the status of the specified resources to @UPDATE_COMPLETE@ and continues to roll back the stack. After the rollback is complete, the state of the skipped resources will be inconsistent with the state of the resources in the stack template. Before performing another stack update, you must update the stack or resources to be consistent with each other. If you don't, subsequent stack updates might fail, and the stack will become unrecoverable. Specify the minimum number of resources required to successfully roll back your stack. For example, a failed resource update might cause dependent resources to fail. In this case, it might not be necessary to skip the dependent resources. To specify resources in a nested stack, use the following format: @NestedStackName.ResourceLogicalID@ . You can specify a nested stack resource (the logical ID of an @AWS::CloudFormation::Stack@ resource) only if it's in one of the following states: @DELETE_IN_PROGRESS@ , @DELETE_COMPLETE@ , or @DELETE_FAILED@ .+curResourcesToSkip :: Lens' ContinueUpdateRollback [Text]+curResourcesToSkip = lens _curResourcesToSkip (\ s a -> s{_curResourcesToSkip = a}) . _Default . _Coerce;++-- | The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes to roll back the stack. AWS CloudFormation uses the role's credentials to make calls on your behalf. AWS CloudFormation always uses this role for all future operations on the stack. As long as users have permission to operate on the stack, AWS CloudFormation uses this role even if the users don't have permission to pass it. Ensure that the role grants least privilege. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.+curRoleARN :: Lens' ContinueUpdateRollback (Maybe Text)+curRoleARN = lens _curRoleARN (\ s a -> s{_curRoleARN = a});+ -- | The name or the unique ID of the stack that you want to continue rolling back. curStackName :: Lens' ContinueUpdateRollback Text curStackName = lens _curStackName (\ s a -> s{_curStackName = a});@@ -93,10 +115,16 @@ ["Action" =: ("ContinueUpdateRollback" :: ByteString), "Version" =: ("2010-05-15" :: ByteString),+ "ResourcesToSkip" =:+ toQuery+ (toQueryList "member" <$> _curResourcesToSkip),+ "RoleARN" =: _curRoleARN, "StackName" =: _curStackName] --- | The output for a < ContinueUpdateRollback> action.+-- | The output for a 'ContinueUpdateRollback' action. --+--+-- -- /See:/ 'continueUpdateRollbackResponse' smart constructor. newtype ContinueUpdateRollbackResponse = ContinueUpdateRollbackResponse' { _currsResponseStatus :: Int@@ -106,7 +134,7 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'currsResponseStatus'+-- * 'currsResponseStatus' - -- | The response status code. continueUpdateRollbackResponse :: Int -- ^ 'currsResponseStatus' -> ContinueUpdateRollbackResponse@@ -115,7 +143,7 @@ { _currsResponseStatus = pResponseStatus_ } --- | The response status code.+-- | -- | The response status code. currsResponseStatus :: Lens' ContinueUpdateRollbackResponse Int currsResponseStatus = lens _currsResponseStatus (\ s a -> s{_currsResponseStatus = a});
gen/Network/AWS/CloudFormation/CreateChangeSet.hs view
@@ -18,17 +18,20 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- Creates a list of changes for a stack. AWS CloudFormation generates the change set by comparing the stack\'s information with the information that you submit. A change set can help you understand which resources AWS CloudFormation will change and how it will change them before you update your stack. Change sets allow you to check before you make a change so that you don\'t delete or replace critical resources.+-- Creates a list of changes for a stack. AWS CloudFormation generates the change set by comparing the template's information with the information that you submit. A change set can help you understand which resources AWS CloudFormation will change, and how it will change them, before you update your stack. Change sets allow you to check before making a change to avoid deleting or replacing critical resources. ----- AWS CloudFormation doesn\'t make any changes to the stack when you create a change set. To make the specified changes, you must execute the change set by using the < ExecuteChangeSet> action. ----- After the call successfully completes, AWS CloudFormation starts creating the change set. To check the status of the change set, use the < DescribeChangeSet> action.+-- AWS CloudFormation doesn't make any changes to the stack when you create a change set. To make the specified changes, you must execute the change set by using the 'ExecuteChangeSet' action.+--+-- After the call successfully completes, AWS CloudFormation starts creating the change set. To check the status of the change set, use the 'DescribeChangeSet' action.+-- module Network.AWS.CloudFormation.CreateChangeSet ( -- * Creating a Request createChangeSet , CreateChangeSet -- * Request Lenses+ , ccsChangeSetType , ccsUsePreviousTemplate , ccsClientToken , ccsNotificationARNs@@ -39,6 +42,7 @@ , ccsCapabilities , ccsResourceTypes , ccsTags+ , ccsRoleARN , ccsStackName , ccsChangeSetName @@ -47,6 +51,7 @@ , CreateChangeSetResponse -- * Response Lenses , ccsrsId+ , ccsrsStackId , ccsrsResponseStatus ) where @@ -57,11 +62,14 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for the < CreateChangeSet> action.+-- | The input for the 'CreateChangeSet' action. --+--+-- -- /See:/ 'createChangeSet' smart constructor. data CreateChangeSet = CreateChangeSet'- { _ccsUsePreviousTemplate :: !(Maybe Bool)+ { _ccsChangeSetType :: !(Maybe ChangeSetType)+ , _ccsUsePreviousTemplate :: !(Maybe Bool) , _ccsClientToken :: !(Maybe Text) , _ccsNotificationARNs :: !(Maybe [Text]) , _ccsParameters :: !(Maybe [Parameter])@@ -71,6 +79,7 @@ , _ccsCapabilities :: !(Maybe [Capability]) , _ccsResourceTypes :: !(Maybe [Text]) , _ccsTags :: !(Maybe [Tag])+ , _ccsRoleARN :: !(Maybe Text) , _ccsStackName :: !Text , _ccsChangeSetName :: !Text } deriving (Eq,Read,Show,Data,Typeable,Generic)@@ -79,36 +88,41 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'ccsUsePreviousTemplate'+-- * 'ccsChangeSetType' - The type of change set operation. To create a change set for a new stack, specify @CREATE@ . To create a change set for an existing stack, specify @UPDATE@ . If you create a change set for a new stack, AWS Cloudformation creates a stack with a unique stack ID, but no template or resources. The stack will be in the <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-describing-stacks.html#d0e11995 @REVIEW_IN_PROGRESS@ > state until you execute the change set. By default, AWS CloudFormation specifies @UPDATE@ . You can't use the @UPDATE@ type to create a change set for a new stack or the @CREATE@ type to create a change set for an existing stack. ----- * 'ccsClientToken'+-- * 'ccsUsePreviousTemplate' - Whether to reuse the template that is associated with the stack to create the change set. ----- * 'ccsNotificationARNs'+-- * 'ccsClientToken' - A unique identifier for this @CreateChangeSet@ request. Specify this token if you plan to retry requests so that AWS CloudFormation knows that you're not attempting to create another change set with the same name. You might retry @CreateChangeSet@ requests to ensure that AWS CloudFormation successfully received them. ----- * 'ccsParameters'+-- * 'ccsNotificationARNs' - The Amazon Resource Names (ARNs) of Amazon Simple Notification Service (Amazon SNS) topics that AWS CloudFormation associates with the stack. To remove all associated notification topics, specify an empty list. ----- * 'ccsTemplateBody'+-- * 'ccsParameters' - A list of @Parameter@ structures that specify input parameters for the change set. For more information, see the <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html Parameter> data type. ----- * 'ccsTemplateURL'+-- * 'ccsTemplateBody' - A structure that contains the body of the revised template, with a minimum length of 1 byte and a maximum length of 51,200 bytes. AWS CloudFormation generates the change set by comparing this template with the template of the stack that you specified. Conditional: You must specify only @TemplateBody@ or @TemplateURL@ . ----- * 'ccsDescription'+-- * 'ccsTemplateURL' - The location of the file that contains the revised template. The URL must point to a template (max size: 460,800 bytes) that is located in an S3 bucket. AWS CloudFormation generates the change set by comparing this template with the stack that you specified. Conditional: You must specify only @TemplateBody@ or @TemplateURL@ . ----- * 'ccsCapabilities'+-- * 'ccsDescription' - A description to help you identify this change set. ----- * 'ccsResourceTypes'+-- * 'ccsCapabilities' - A list of values that you must specify before AWS CloudFormation can update certain stacks. Some stack templates might include resources that can affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this parameter. The only valid values are @CAPABILITY_IAM@ and @CAPABILITY_NAMED_IAM@ . The following resources require you to specify this parameter: <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html AWS::IAM::AccessKey> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html AWS::IAM::Group> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html AWS::IAM::InstanceProfile> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html AWS::IAM::Policy> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html AWS::IAM::Role> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html AWS::IAM::User> , and <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html AWS::IAM::UserToGroupAddition> . If your stack template contains these resources, we recommend that you review all permissions associated with them and edit their permissions if necessary. If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify @CAPABILITY_NAMED_IAM@ . If you don't specify this parameter, this action returns an @InsufficientCapabilities@ error. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates> . ----- * 'ccsTags'+-- * 'ccsResourceTypes' - The template resource types that you have permissions to work with if you execute this change set, such as @AWS::EC2::Instance@ , @AWS::EC2::*@ , or @Custom::MyCustomInstance@ . If the list of resource types doesn't include a resource type that you're updating, the stack update fails. By default, AWS CloudFormation grants permissions to all resource types. AWS Identity and Access Management (IAM) uses this parameter for condition keys in IAM policies for AWS CloudFormation. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html Controlling Access with AWS Identity and Access Management> in the AWS CloudFormation User Guide. ----- * 'ccsStackName'+-- * 'ccsTags' - Key-value pairs to associate with this stack. AWS CloudFormation also propagates these tags to resources in the stack. You can specify a maximum of 10 tags. ----- * 'ccsChangeSetName'+-- * 'ccsRoleARN' - The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes when executing the change set. AWS CloudFormation uses the role's credentials to make calls on your behalf. AWS CloudFormation uses this role for all future operations on the stack. As long as users have permission to operate on the stack, AWS CloudFormation uses this role even if the users don't have permission to pass it. Ensure that the role grants least privilege. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.+--+-- * 'ccsStackName' - The name or the unique ID of the stack for which you are creating a change set. AWS CloudFormation generates the change set by comparing this stack's information with the information that you submit, such as a modified template or different parameter input values.+--+-- * 'ccsChangeSetName' - The name of the change set. The name must be unique among all change sets that are associated with the specified stack. A change set name can contain only alphanumeric, case sensitive characters and hyphens. It must start with an alphabetic character and cannot exceed 128 characters. createChangeSet :: Text -- ^ 'ccsStackName' -> Text -- ^ 'ccsChangeSetName' -> CreateChangeSet createChangeSet pStackName_ pChangeSetName_ = CreateChangeSet'- { _ccsUsePreviousTemplate = Nothing+ { _ccsChangeSetType = Nothing+ , _ccsUsePreviousTemplate = Nothing , _ccsClientToken = Nothing , _ccsNotificationARNs = Nothing , _ccsParameters = Nothing@@ -118,15 +132,20 @@ , _ccsCapabilities = Nothing , _ccsResourceTypes = Nothing , _ccsTags = Nothing+ , _ccsRoleARN = Nothing , _ccsStackName = pStackName_ , _ccsChangeSetName = pChangeSetName_ } +-- | The type of change set operation. To create a change set for a new stack, specify @CREATE@ . To create a change set for an existing stack, specify @UPDATE@ . If you create a change set for a new stack, AWS Cloudformation creates a stack with a unique stack ID, but no template or resources. The stack will be in the <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-describing-stacks.html#d0e11995 @REVIEW_IN_PROGRESS@ > state until you execute the change set. By default, AWS CloudFormation specifies @UPDATE@ . You can't use the @UPDATE@ type to create a change set for a new stack or the @CREATE@ type to create a change set for an existing stack.+ccsChangeSetType :: Lens' CreateChangeSet (Maybe ChangeSetType)+ccsChangeSetType = lens _ccsChangeSetType (\ s a -> s{_ccsChangeSetType = a});+ -- | Whether to reuse the template that is associated with the stack to create the change set. ccsUsePreviousTemplate :: Lens' CreateChangeSet (Maybe Bool) ccsUsePreviousTemplate = lens _ccsUsePreviousTemplate (\ s a -> s{_ccsUsePreviousTemplate = a}); --- | A unique identifier for this 'CreateChangeSet' request. Specify this token if you plan to retry requests so that AWS CloudFormation knows that you\'re not attempting to create another change set with the same name. You might retry 'CreateChangeSet' requests to ensure that AWS CloudFormation successfully received them.+-- | A unique identifier for this @CreateChangeSet@ request. Specify this token if you plan to retry requests so that AWS CloudFormation knows that you're not attempting to create another change set with the same name. You might retry @CreateChangeSet@ requests to ensure that AWS CloudFormation successfully received them. ccsClientToken :: Lens' CreateChangeSet (Maybe Text) ccsClientToken = lens _ccsClientToken (\ s a -> s{_ccsClientToken = a}); @@ -134,19 +153,15 @@ ccsNotificationARNs :: Lens' CreateChangeSet [Text] ccsNotificationARNs = lens _ccsNotificationARNs (\ s a -> s{_ccsNotificationARNs = a}) . _Default . _Coerce; --- | A list of 'Parameter' structures that specify input parameters for the change set. For more information, see the <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html Parameter> data type.+-- | A list of @Parameter@ structures that specify input parameters for the change set. For more information, see the <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html Parameter> data type. ccsParameters :: Lens' CreateChangeSet [Parameter] ccsParameters = lens _ccsParameters (\ s a -> s{_ccsParameters = a}) . _Default . _Coerce; --- | A structure that contains the body of the revised template, with a minimum length of 1 byte and a maximum length of 51,200 bytes. AWS CloudFormation generates the change set by comparing this template with the template of the stack that you specified.------ Conditional: You must specify only 'TemplateBody' or 'TemplateURL'.+-- | A structure that contains the body of the revised template, with a minimum length of 1 byte and a maximum length of 51,200 bytes. AWS CloudFormation generates the change set by comparing this template with the template of the stack that you specified. Conditional: You must specify only @TemplateBody@ or @TemplateURL@ . ccsTemplateBody :: Lens' CreateChangeSet (Maybe Text) ccsTemplateBody = lens _ccsTemplateBody (\ s a -> s{_ccsTemplateBody = a}); --- | The location of the file that contains the revised template. The URL must point to a template (max size: 460,800 bytes) that is located in an S3 bucket. AWS CloudFormation generates the change set by comparing this template with the stack that you specified.------ Conditional: You must specify only 'TemplateBody' or 'TemplateURL'.+-- | The location of the file that contains the revised template. The URL must point to a template (max size: 460,800 bytes) that is located in an S3 bucket. AWS CloudFormation generates the change set by comparing this template with the stack that you specified. Conditional: You must specify only @TemplateBody@ or @TemplateURL@ . ccsTemplateURL :: Lens' CreateChangeSet (Maybe Text) ccsTemplateURL = lens _ccsTemplateURL (\ s a -> s{_ccsTemplateURL = a}); @@ -154,19 +169,11 @@ ccsDescription :: Lens' CreateChangeSet (Maybe Text) ccsDescription = lens _ccsDescription (\ s a -> s{_ccsDescription = a}); --- | A list of values that you must specify before AWS CloudFormation can update certain stacks. Some stack templates might include resources that can affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this parameter.------ The only valid values are 'CAPABILITY_IAM' and 'CAPABILITY_NAMED_IAM'. The following resources require you to specify this parameter: <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html AWS::IAM::AccessKey>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html AWS::IAM::Group>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html AWS::IAM::InstanceProfile>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html AWS::IAM::Policy>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html AWS::IAM::Role>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html AWS::IAM::User>, and <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html AWS::IAM::UserToGroupAddition>. If your stack template contains these resources, we recommend that you review all permissions associated with them and edit their permissions if necessary.------ If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify 'CAPABILITY_NAMED_IAM'. If you don\'t specify this parameter, this action returns an 'InsufficientCapabilities' error.------ For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates>.+-- | A list of values that you must specify before AWS CloudFormation can update certain stacks. Some stack templates might include resources that can affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this parameter. The only valid values are @CAPABILITY_IAM@ and @CAPABILITY_NAMED_IAM@ . The following resources require you to specify this parameter: <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html AWS::IAM::AccessKey> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html AWS::IAM::Group> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html AWS::IAM::InstanceProfile> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html AWS::IAM::Policy> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html AWS::IAM::Role> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html AWS::IAM::User> , and <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html AWS::IAM::UserToGroupAddition> . If your stack template contains these resources, we recommend that you review all permissions associated with them and edit their permissions if necessary. If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify @CAPABILITY_NAMED_IAM@ . If you don't specify this parameter, this action returns an @InsufficientCapabilities@ error. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates> . ccsCapabilities :: Lens' CreateChangeSet [Capability] ccsCapabilities = lens _ccsCapabilities (\ s a -> s{_ccsCapabilities = a}) . _Default . _Coerce; --- | The template resource types that you have permissions to work with if you execute this change set, such as 'AWS::EC2::Instance', 'AWS::EC2::*', or 'Custom::MyCustomInstance'.------ If the list of resource types doesn\'t include a resource type that you\'re updating, the stack update fails. By default, AWS CloudFormation grants permissions to all resource types. AWS Identity and Access Management (IAM) uses this parameter for condition keys in IAM policies for AWS CloudFormation. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html Controlling Access with AWS Identity and Access Management> in the AWS CloudFormation User Guide.+-- | The template resource types that you have permissions to work with if you execute this change set, such as @AWS::EC2::Instance@ , @AWS::EC2::*@ , or @Custom::MyCustomInstance@ . If the list of resource types doesn't include a resource type that you're updating, the stack update fails. By default, AWS CloudFormation grants permissions to all resource types. AWS Identity and Access Management (IAM) uses this parameter for condition keys in IAM policies for AWS CloudFormation. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html Controlling Access with AWS Identity and Access Management> in the AWS CloudFormation User Guide. ccsResourceTypes :: Lens' CreateChangeSet [Text] ccsResourceTypes = lens _ccsResourceTypes (\ s a -> s{_ccsResourceTypes = a}) . _Default . _Coerce; @@ -174,13 +181,15 @@ ccsTags :: Lens' CreateChangeSet [Tag] ccsTags = lens _ccsTags (\ s a -> s{_ccsTags = a}) . _Default . _Coerce; --- | The name or the unique ID of the stack for which you are creating a change set. AWS CloudFormation generates the change set by comparing this stack\'s information with the information that you submit, such as a modified template or different parameter input values.+-- | The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes when executing the change set. AWS CloudFormation uses the role's credentials to make calls on your behalf. AWS CloudFormation uses this role for all future operations on the stack. As long as users have permission to operate on the stack, AWS CloudFormation uses this role even if the users don't have permission to pass it. Ensure that the role grants least privilege. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.+ccsRoleARN :: Lens' CreateChangeSet (Maybe Text)+ccsRoleARN = lens _ccsRoleARN (\ s a -> s{_ccsRoleARN = a});++-- | The name or the unique ID of the stack for which you are creating a change set. AWS CloudFormation generates the change set by comparing this stack's information with the information that you submit, such as a modified template or different parameter input values. ccsStackName :: Lens' CreateChangeSet Text ccsStackName = lens _ccsStackName (\ s a -> s{_ccsStackName = a}); --- | The name of the change set. The name must be unique among all change sets that are associated with the specified stack.------ A change set name can contain only alphanumeric, case sensitive characters and hyphens. It must start with an alphabetic character and cannot exceed 128 characters.+-- | The name of the change set. The name must be unique among all change sets that are associated with the specified stack. A change set name can contain only alphanumeric, case sensitive characters and hyphens. It must start with an alphabetic character and cannot exceed 128 characters. ccsChangeSetName :: Lens' CreateChangeSet Text ccsChangeSetName = lens _ccsChangeSetName (\ s a -> s{_ccsChangeSetName = a}); @@ -191,7 +200,8 @@ = receiveXMLWrapper "CreateChangeSetResult" (\ s h x -> CreateChangeSetResponse' <$>- (x .@? "Id") <*> (pure (fromEnum s)))+ (x .@? "Id") <*> (x .@? "StackId") <*>+ (pure (fromEnum s))) instance Hashable CreateChangeSet @@ -208,6 +218,7 @@ = mconcat ["Action" =: ("CreateChangeSet" :: ByteString), "Version" =: ("2010-05-15" :: ByteString),+ "ChangeSetType" =: _ccsChangeSetType, "UsePreviousTemplate" =: _ccsUsePreviousTemplate, "ClientToken" =: _ccsClientToken, "NotificationARNs" =:@@ -224,14 +235,18 @@ toQuery (toQueryList "member" <$> _ccsResourceTypes), "Tags" =: toQuery (toQueryList "member" <$> _ccsTags),+ "RoleARN" =: _ccsRoleARN, "StackName" =: _ccsStackName, "ChangeSetName" =: _ccsChangeSetName] --- | The output for the < CreateChangeSet> action.+-- | The output for the 'CreateChangeSet' action. --+--+-- -- /See:/ 'createChangeSetResponse' smart constructor. data CreateChangeSetResponse = CreateChangeSetResponse' { _ccsrsId :: !(Maybe Text)+ , _ccsrsStackId :: !(Maybe Text) , _ccsrsResponseStatus :: !Int } deriving (Eq,Read,Show,Data,Typeable,Generic) @@ -239,15 +254,18 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'ccsrsId'+-- * 'ccsrsId' - The Amazon Resource Name (ARN) of the change set. ----- * 'ccsrsResponseStatus'+-- * 'ccsrsStackId' - The unique ID of the stack.+--+-- * 'ccsrsResponseStatus' - -- | The response status code. createChangeSetResponse :: Int -- ^ 'ccsrsResponseStatus' -> CreateChangeSetResponse createChangeSetResponse pResponseStatus_ = CreateChangeSetResponse' { _ccsrsId = Nothing+ , _ccsrsStackId = Nothing , _ccsrsResponseStatus = pResponseStatus_ } @@ -255,7 +273,11 @@ ccsrsId :: Lens' CreateChangeSetResponse (Maybe Text) ccsrsId = lens _ccsrsId (\ s a -> s{_ccsrsId = a}); --- | The response status code.+-- | The unique ID of the stack.+ccsrsStackId :: Lens' CreateChangeSetResponse (Maybe Text)+ccsrsStackId = lens _ccsrsStackId (\ s a -> s{_ccsrsStackId = a});++-- | -- | The response status code. ccsrsResponseStatus :: Lens' CreateChangeSetResponse Int ccsrsResponseStatus = lens _ccsrsResponseStatus (\ s a -> s{_ccsrsResponseStatus = a});
gen/Network/AWS/CloudFormation/CreateStack.hs view
@@ -18,7 +18,9 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- Creates a stack as specified in the template. After the call completes successfully, the stack creation starts. You can check the status of the stack via the < DescribeStacks> API.+-- Creates a stack as specified in the template. After the call completes successfully, the stack creation starts. You can check the status of the stack via the 'DescribeStacks' API.+--+-- module Network.AWS.CloudFormation.CreateStack ( -- * Creating a Request@@ -37,6 +39,7 @@ , csResourceTypes , csTags , csTimeoutInMinutes+ , csRoleARN , csStackName -- * Destructuring the Response@@ -54,8 +57,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for < CreateStack> action.+-- | The input for 'CreateStack' action. --+--+-- -- /See:/ 'createStack' smart constructor. data CreateStack = CreateStack' { _csDisableRollback :: !(Maybe Bool)@@ -70,6 +75,7 @@ , _csResourceTypes :: !(Maybe [Text]) , _csTags :: !(Maybe [Tag]) , _csTimeoutInMinutes :: !(Maybe Nat)+ , _csRoleARN :: !(Maybe Text) , _csStackName :: !Text } deriving (Eq,Read,Show,Data,Typeable,Generic) @@ -77,31 +83,33 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'csDisableRollback'+-- * 'csDisableRollback' - Set to @true@ to disable rollback of the stack if stack creation failed. You can specify either @DisableRollback@ or @OnFailure@ , but not both. Default: @false@ ----- * 'csNotificationARNs'+-- * 'csNotificationARNs' - The Simple Notification Service (SNS) topic ARNs to publish stack related events. You can find your SNS topic ARNs using the <https://console.aws.amazon.com/sns SNS console> or your Command Line Interface (CLI). ----- * 'csStackPolicyBody'+-- * 'csStackPolicyBody' - Structure containing the stack policy body. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/protect-stack-resources.html Prevent Updates to Stack Resources> in the /AWS CloudFormation User Guide/ . You can specify either the @StackPolicyBody@ or the @StackPolicyURL@ parameter, but not both. ----- * 'csParameters'+-- * 'csParameters' - A list of @Parameter@ structures that specify input parameters for the stack. For more information, see the <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html Parameter> data type. ----- * 'csStackPolicyURL'+-- * 'csStackPolicyURL' - Location of a file containing the stack policy. The URL must point to a policy (maximum size: 16 KB) located in an S3 bucket in the same region as the stack. You can specify either the @StackPolicyBody@ or the @StackPolicyURL@ parameter, but not both. ----- * 'csTemplateBody'+-- * 'csTemplateBody' - Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must specify either the @TemplateBody@ or the @TemplateURL@ parameter, but not both. ----- * 'csTemplateURL'+-- * 'csTemplateURL' - Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information, go to the <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must specify either the @TemplateBody@ or the @TemplateURL@ parameter, but not both. ----- * 'csCapabilities'+-- * 'csCapabilities' - A list of values that you must specify before AWS CloudFormation can create certain stacks. Some stack templates might include resources that can affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this parameter. The only valid values are @CAPABILITY_IAM@ and @CAPABILITY_NAMED_IAM@ . The following resources require you to specify this parameter: <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html AWS::IAM::AccessKey> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html AWS::IAM::Group> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html AWS::IAM::InstanceProfile> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html AWS::IAM::Policy> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html AWS::IAM::Role> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html AWS::IAM::User> , and <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html AWS::IAM::UserToGroupAddition> . If your stack template contains these resources, we recommend that you review all permissions associated with them and edit their permissions if necessary. If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify @CAPABILITY_NAMED_IAM@ . If you don't specify this parameter, this action returns an @InsufficientCapabilities@ error. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates> . ----- * 'csOnFailure'+-- * 'csOnFailure' - Determines what action will be taken if stack creation fails. This must be one of: DO_NOTHING, ROLLBACK, or DELETE. You can specify either @OnFailure@ or @DisableRollback@ , but not both. Default: @ROLLBACK@ ----- * 'csResourceTypes'+-- * 'csResourceTypes' - The template resource types that you have permissions to work with for this create stack action, such as @AWS::EC2::Instance@ , @AWS::EC2::*@ , or @Custom::MyCustomInstance@ . Use the following syntax to describe template resource types: @AWS::*@ (for all AWS resource), @Custom::*@ (for all custom resources), @Custom::/logical_ID/ @ (for a specific custom resource), @AWS::/service_name/ ::*@ (for all resources of a particular AWS service), and @AWS::/service_name/ ::/resource_logical_ID/ @ (for a specific AWS resource). If the list of resource types doesn't include a resource that you're creating, the stack creation fails. By default, AWS CloudFormation grants permissions to all resource types. AWS Identity and Access Management (IAM) uses this parameter for AWS CloudFormation-specific condition keys in IAM policies. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html Controlling Access with AWS Identity and Access Management> . ----- * 'csTags'+-- * 'csTags' - Key-value pairs to associate with this stack. AWS CloudFormation also propagates these tags to the resources created in the stack. A maximum number of 10 tags can be specified. ----- * 'csTimeoutInMinutes'+-- * 'csTimeoutInMinutes' - The amount of time that can pass before the stack status becomes CREATE_FAILED; if @DisableRollback@ is not set or is set to @false@ , the stack will be rolled back. ----- * 'csStackName'+-- * 'csRoleARN' - The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes to create the stack. AWS CloudFormation uses the role's credentials to make calls on your behalf. AWS CloudFormation always uses this role for all future operations on the stack. As long as users have permission to operate on the stack, AWS CloudFormation uses this role even if the users don't have permission to pass it. Ensure that the role grants least privilege. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.+--+-- * 'csStackName' - The name that is associated with the stack. The name must be unique in the region in which you are creating the stack. createStack :: Text -- ^ 'csStackName' -> CreateStack@@ -119,12 +127,11 @@ , _csResourceTypes = Nothing , _csTags = Nothing , _csTimeoutInMinutes = Nothing+ , _csRoleARN = Nothing , _csStackName = pStackName_ } --- | Set to 'true' to disable rollback of the stack if stack creation failed. You can specify either 'DisableRollback' or 'OnFailure', but not both.------ Default: 'false'+-- | Set to @true@ to disable rollback of the stack if stack creation failed. You can specify either @DisableRollback@ or @OnFailure@ , but not both. Default: @false@ csDisableRollback :: Lens' CreateStack (Maybe Bool) csDisableRollback = lens _csDisableRollback (\ s a -> s{_csDisableRollback = a}); @@ -132,49 +139,35 @@ csNotificationARNs :: Lens' CreateStack [Text] csNotificationARNs = lens _csNotificationARNs (\ s a -> s{_csNotificationARNs = a}) . _Default . _Coerce; --- | Structure containing the stack policy body. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/protect-stack-resources.html Prevent Updates to Stack Resources> in the AWS CloudFormation User Guide. You can specify either the 'StackPolicyBody' or the 'StackPolicyURL' parameter, but not both.+-- | Structure containing the stack policy body. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/protect-stack-resources.html Prevent Updates to Stack Resources> in the /AWS CloudFormation User Guide/ . You can specify either the @StackPolicyBody@ or the @StackPolicyURL@ parameter, but not both. csStackPolicyBody :: Lens' CreateStack (Maybe Text) csStackPolicyBody = lens _csStackPolicyBody (\ s a -> s{_csStackPolicyBody = a}); --- | A list of 'Parameter' structures that specify input parameters for the stack. For more information, see the <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html Parameter> data type.+-- | A list of @Parameter@ structures that specify input parameters for the stack. For more information, see the <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html Parameter> data type. csParameters :: Lens' CreateStack [Parameter] csParameters = lens _csParameters (\ s a -> s{_csParameters = a}) . _Default . _Coerce; --- | Location of a file containing the stack policy. The URL must point to a policy (max size: 16KB) located in an S3 bucket in the same region as the stack. You can specify either the 'StackPolicyBody' or the 'StackPolicyURL' parameter, but not both.+-- | Location of a file containing the stack policy. The URL must point to a policy (maximum size: 16 KB) located in an S3 bucket in the same region as the stack. You can specify either the @StackPolicyBody@ or the @StackPolicyURL@ parameter, but not both. csStackPolicyURL :: Lens' CreateStack (Maybe Text) csStackPolicyURL = lens _csStackPolicyURL (\ s a -> s{_csStackPolicyURL = a}); --- | Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.------ Conditional: You must specify either the 'TemplateBody' or the 'TemplateURL' parameter, but not both.+-- | Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must specify either the @TemplateBody@ or the @TemplateURL@ parameter, but not both. csTemplateBody :: Lens' CreateStack (Maybe Text) csTemplateBody = lens _csTemplateBody (\ s a -> s{_csTemplateBody = a}); --- | Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information, go to the <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.------ Conditional: You must specify either the 'TemplateBody' or the 'TemplateURL' parameter, but not both.+-- | Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information, go to the <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must specify either the @TemplateBody@ or the @TemplateURL@ parameter, but not both. csTemplateURL :: Lens' CreateStack (Maybe Text) csTemplateURL = lens _csTemplateURL (\ s a -> s{_csTemplateURL = a}); --- | A list of values that you must specify before AWS CloudFormation can create certain stacks. Some stack templates might include resources that can affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this parameter.------ The only valid values are 'CAPABILITY_IAM' and 'CAPABILITY_NAMED_IAM'. The following resources require you to specify this parameter: <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html AWS::IAM::AccessKey>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html AWS::IAM::Group>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html AWS::IAM::InstanceProfile>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html AWS::IAM::Policy>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html AWS::IAM::Role>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html AWS::IAM::User>, and <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html AWS::IAM::UserToGroupAddition>. If your stack template contains these resources, we recommend that you review all permissions associated with them and edit their permissions if necessary.------ If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify 'CAPABILITY_NAMED_IAM'. If you don\'t specify this parameter, this action returns an 'InsufficientCapabilities' error.------ For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates>.+-- | A list of values that you must specify before AWS CloudFormation can create certain stacks. Some stack templates might include resources that can affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this parameter. The only valid values are @CAPABILITY_IAM@ and @CAPABILITY_NAMED_IAM@ . The following resources require you to specify this parameter: <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html AWS::IAM::AccessKey> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html AWS::IAM::Group> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html AWS::IAM::InstanceProfile> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html AWS::IAM::Policy> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html AWS::IAM::Role> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html AWS::IAM::User> , and <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html AWS::IAM::UserToGroupAddition> . If your stack template contains these resources, we recommend that you review all permissions associated with them and edit their permissions if necessary. If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify @CAPABILITY_NAMED_IAM@ . If you don't specify this parameter, this action returns an @InsufficientCapabilities@ error. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates> . csCapabilities :: Lens' CreateStack [Capability] csCapabilities = lens _csCapabilities (\ s a -> s{_csCapabilities = a}) . _Default . _Coerce; --- | Determines what action will be taken if stack creation fails. This must be one of: DO_NOTHING, ROLLBACK, or DELETE. You can specify either 'OnFailure' or 'DisableRollback', but not both.------ Default: 'ROLLBACK'+-- | Determines what action will be taken if stack creation fails. This must be one of: DO_NOTHING, ROLLBACK, or DELETE. You can specify either @OnFailure@ or @DisableRollback@ , but not both. Default: @ROLLBACK@ csOnFailure :: Lens' CreateStack (Maybe OnFailure) csOnFailure = lens _csOnFailure (\ s a -> s{_csOnFailure = a}); --- | The template resource types that you have permissions to work with for this create stack action, such as 'AWS::EC2::Instance', 'AWS::EC2::*', or 'Custom::MyCustomInstance'. Use the following syntax to describe template resource types: 'AWS::*' (for all AWS resource), 'Custom::*' (for all custom resources), 'Custom::logical_ID ' (for a specific custom resource), 'AWS::service_name::*' (for all resources of a particular AWS service), and 'AWS::service_name::resource_logical_ID ' (for a specific AWS resource).------ If the list of resource types doesn\'t include a resource that you\'re creating, the stack creation fails. By default, AWS CloudFormation grants permissions to all resource types. AWS Identity and Access Management (IAM) uses this parameter for AWS CloudFormation-specific condition keys in IAM policies. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html Controlling Access with AWS Identity and Access Management>.+-- | The template resource types that you have permissions to work with for this create stack action, such as @AWS::EC2::Instance@ , @AWS::EC2::*@ , or @Custom::MyCustomInstance@ . Use the following syntax to describe template resource types: @AWS::*@ (for all AWS resource), @Custom::*@ (for all custom resources), @Custom::/logical_ID/ @ (for a specific custom resource), @AWS::/service_name/ ::*@ (for all resources of a particular AWS service), and @AWS::/service_name/ ::/resource_logical_ID/ @ (for a specific AWS resource). If the list of resource types doesn't include a resource that you're creating, the stack creation fails. By default, AWS CloudFormation grants permissions to all resource types. AWS Identity and Access Management (IAM) uses this parameter for AWS CloudFormation-specific condition keys in IAM policies. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html Controlling Access with AWS Identity and Access Management> . csResourceTypes :: Lens' CreateStack [Text] csResourceTypes = lens _csResourceTypes (\ s a -> s{_csResourceTypes = a}) . _Default . _Coerce; @@ -182,13 +175,15 @@ csTags :: Lens' CreateStack [Tag] csTags = lens _csTags (\ s a -> s{_csTags = a}) . _Default . _Coerce; --- | The amount of time that can pass before the stack status becomes CREATE_FAILED; if 'DisableRollback' is not set or is set to 'false', the stack will be rolled back.+-- | The amount of time that can pass before the stack status becomes CREATE_FAILED; if @DisableRollback@ is not set or is set to @false@ , the stack will be rolled back. csTimeoutInMinutes :: Lens' CreateStack (Maybe Natural) csTimeoutInMinutes = lens _csTimeoutInMinutes (\ s a -> s{_csTimeoutInMinutes = a}) . mapping _Nat; +-- | The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes to create the stack. AWS CloudFormation uses the role's credentials to make calls on your behalf. AWS CloudFormation always uses this role for all future operations on the stack. As long as users have permission to operate on the stack, AWS CloudFormation uses this role even if the users don't have permission to pass it. Ensure that the role grants least privilege. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.+csRoleARN :: Lens' CreateStack (Maybe Text)+csRoleARN = lens _csRoleARN (\ s a -> s{_csRoleARN = a});+ -- | The name that is associated with the stack. The name must be unique in the region in which you are creating the stack.------ A stack name can contain only alphanumeric characters (case sensitive) and hyphens. It must start with an alphabetic character and cannot be longer than 128 characters. csStackName :: Lens' CreateStack Text csStackName = lens _csStackName (\ s a -> s{_csStackName = a}); @@ -233,10 +228,12 @@ toQuery (toQueryList "member" <$> _csResourceTypes), "Tags" =: toQuery (toQueryList "member" <$> _csTags), "TimeoutInMinutes" =: _csTimeoutInMinutes,- "StackName" =: _csStackName]+ "RoleARN" =: _csRoleARN, "StackName" =: _csStackName] --- | The output for a < CreateStack> action.+-- | The output for a 'CreateStack' action. --+--+-- -- /See:/ 'createStackResponse' smart constructor. data CreateStackResponse = CreateStackResponse' { _csrsStackId :: !(Maybe Text)@@ -247,9 +244,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'csrsStackId'+-- * 'csrsStackId' - Unique identifier of the stack. ----- * 'csrsResponseStatus'+-- * 'csrsResponseStatus' - -- | The response status code. createStackResponse :: Int -- ^ 'csrsResponseStatus' -> CreateStackResponse@@ -263,7 +260,7 @@ csrsStackId :: Lens' CreateStackResponse (Maybe Text) csrsStackId = lens _csrsStackId (\ s a -> s{_csrsStackId = a}); --- | The response status code.+-- | -- | The response status code. csrsResponseStatus :: Lens' CreateStackResponse Int csrsResponseStatus = lens _csrsResponseStatus (\ s a -> s{_csrsResponseStatus = a});
gen/Network/AWS/CloudFormation/DeleteChangeSet.hs view
@@ -20,7 +20,9 @@ -- -- Deletes the specified change set. Deleting change sets ensures that no one executes the wrong change set. --+-- -- If the call successfully completes, AWS CloudFormation successfully deleted the change set.+-- module Network.AWS.CloudFormation.DeleteChangeSet ( -- * Creating a Request@@ -44,8 +46,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for the < DeleteChangeSet> action.+-- | The input for the 'DeleteChangeSet' action. --+--+-- -- /See:/ 'deleteChangeSet' smart constructor. data DeleteChangeSet = DeleteChangeSet' { _dcsStackName :: !(Maybe Text)@@ -56,9 +60,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'dcsStackName'+-- * 'dcsStackName' - If you specified the name of a change set to delete, specify the stack name or ID (ARN) that is associated with it. ----- * 'dcsChangeSetName'+-- * 'dcsChangeSetName' - The name or Amazon Resource Name (ARN) of the change set that you want to delete. deleteChangeSet :: Text -- ^ 'dcsChangeSetName' -> DeleteChangeSet@@ -102,8 +106,10 @@ "StackName" =: _dcsStackName, "ChangeSetName" =: _dcsChangeSetName] --- | The output for the < DeleteChangeSet> action.+-- | The output for the 'DeleteChangeSet' action. --+--+-- -- /See:/ 'deleteChangeSetResponse' smart constructor. newtype DeleteChangeSetResponse = DeleteChangeSetResponse' { _dcsrsResponseStatus :: Int@@ -113,7 +119,7 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'dcsrsResponseStatus'+-- * 'dcsrsResponseStatus' - -- | The response status code. deleteChangeSetResponse :: Int -- ^ 'dcsrsResponseStatus' -> DeleteChangeSetResponse@@ -122,7 +128,7 @@ { _dcsrsResponseStatus = pResponseStatus_ } --- | The response status code.+-- | -- | The response status code. dcsrsResponseStatus :: Lens' DeleteChangeSetResponse Int dcsrsResponseStatus = lens _dcsrsResponseStatus (\ s a -> s{_dcsrsResponseStatus = a});
gen/Network/AWS/CloudFormation/DeleteStack.hs view
@@ -18,7 +18,9 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- Deletes a specified stack. Once the call completes successfully, stack deletion starts. Deleted stacks do not show up in the < DescribeStacks> API if the deletion has been completed successfully.+-- Deletes a specified stack. Once the call completes successfully, stack deletion starts. Deleted stacks do not show up in the 'DescribeStacks' API if the deletion has been completed successfully.+--+-- module Network.AWS.CloudFormation.DeleteStack ( -- * Creating a Request@@ -26,6 +28,7 @@ , DeleteStack -- * Request Lenses , dsRetainResources+ , dsRoleARN , dsStackName -- * Destructuring the Response@@ -40,11 +43,14 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for < DeleteStack> action.+-- | The input for 'DeleteStack' action. --+--+-- -- /See:/ 'deleteStack' smart constructor. data DeleteStack = DeleteStack' { _dsRetainResources :: !(Maybe [Text])+ , _dsRoleARN :: !(Maybe Text) , _dsStackName :: !Text } deriving (Eq,Read,Show,Data,Typeable,Generic) @@ -52,24 +58,29 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'dsRetainResources'+-- * 'dsRetainResources' - For stacks in the @DELETE_FAILED@ state, a list of resource logical IDs that are associated with the resources you want to retain. During deletion, AWS CloudFormation deletes the stack but does not delete the retained resources. Retaining resources is useful when you cannot delete a resource, such as a non-empty S3 bucket, but you want to delete the stack. ----- * 'dsStackName'+-- * 'dsRoleARN' - The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes to delete the stack. AWS CloudFormation uses the role's credentials to make calls on your behalf. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.+--+-- * 'dsStackName' - The name or the unique stack ID that is associated with the stack. deleteStack :: Text -- ^ 'dsStackName' -> DeleteStack deleteStack pStackName_ = DeleteStack' { _dsRetainResources = Nothing+ , _dsRoleARN = Nothing , _dsStackName = pStackName_ } --- | For stacks in the 'DELETE_FAILED' state, a list of resource logical IDs that are associated with the resources you want to retain. During deletion, AWS CloudFormation deletes the stack but does not delete the retained resources.------ Retaining resources is useful when you cannot delete a resource, such as a non-empty S3 bucket, but you want to delete the stack.+-- | For stacks in the @DELETE_FAILED@ state, a list of resource logical IDs that are associated with the resources you want to retain. During deletion, AWS CloudFormation deletes the stack but does not delete the retained resources. Retaining resources is useful when you cannot delete a resource, such as a non-empty S3 bucket, but you want to delete the stack. dsRetainResources :: Lens' DeleteStack [Text] dsRetainResources = lens _dsRetainResources (\ s a -> s{_dsRetainResources = a}) . _Default . _Coerce; +-- | The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes to delete the stack. AWS CloudFormation uses the role's credentials to make calls on your behalf. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.+dsRoleARN :: Lens' DeleteStack (Maybe Text)+dsRoleARN = lens _dsRoleARN (\ s a -> s{_dsRoleARN = a});+ -- | The name or the unique stack ID that is associated with the stack. dsStackName :: Lens' DeleteStack Text dsStackName = lens _dsStackName (\ s a -> s{_dsStackName = a});@@ -97,7 +108,7 @@ "RetainResources" =: toQuery (toQueryList "member" <$> _dsRetainResources),- "StackName" =: _dsStackName]+ "RoleARN" =: _dsRoleARN, "StackName" =: _dsStackName] -- | /See:/ 'deleteStackResponse' smart constructor. data DeleteStackResponse =
gen/Network/AWS/CloudFormation/DescribeAccountLimits.hs view
@@ -18,7 +18,9 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- Retrieves your account\'s AWS CloudFormation limits, such as the maximum number of stacks that you can create in your account.+-- Retrieves your account's AWS CloudFormation limits, such as the maximum number of stacks that you can create in your account.+--+-- module Network.AWS.CloudFormation.DescribeAccountLimits ( -- * Creating a Request@@ -43,8 +45,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for the < DescribeAccountLimits> action.+-- | The input for the 'DescribeAccountLimits' action. --+--+-- -- /See:/ 'describeAccountLimits' smart constructor. newtype DescribeAccountLimits = DescribeAccountLimits' { _dalNextToken :: Maybe Text@@ -54,7 +58,7 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'dalNextToken'+-- * 'dalNextToken' - A string that identifies the next page of limits that you want to retrieve. describeAccountLimits :: DescribeAccountLimits describeAccountLimits =@@ -96,8 +100,10 @@ "Version" =: ("2010-05-15" :: ByteString), "NextToken" =: _dalNextToken] --- | The output for the < DescribeAccountLimits> action.+-- | The output for the 'DescribeAccountLimits' action. --+--+-- -- /See:/ 'describeAccountLimitsResponse' smart constructor. data DescribeAccountLimitsResponse = DescribeAccountLimitsResponse' { _dalrsNextToken :: !(Maybe Text)@@ -109,11 +115,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'dalrsNextToken'+-- * 'dalrsNextToken' - If the output exceeds 1 MB in size, a string that identifies the next page of limits. If no additional page exists, this value is null. ----- * 'dalrsAccountLimits'+-- * 'dalrsAccountLimits' - An account limit structure that contain a list of AWS CloudFormation account limits and their values. ----- * 'dalrsResponseStatus'+-- * 'dalrsResponseStatus' - -- | The response status code. describeAccountLimitsResponse :: Int -- ^ 'dalrsResponseStatus' -> DescribeAccountLimitsResponse@@ -132,7 +138,7 @@ dalrsAccountLimits :: Lens' DescribeAccountLimitsResponse [AccountLimit] dalrsAccountLimits = lens _dalrsAccountLimits (\ s a -> s{_dalrsAccountLimits = a}) . _Default . _Coerce; --- | The response status code.+-- | -- | The response status code. dalrsResponseStatus :: Lens' DescribeAccountLimitsResponse Int dalrsResponseStatus = lens _dalrsResponseStatus (\ s a -> s{_dalrsResponseStatus = a});
gen/Network/AWS/CloudFormation/DescribeChangeSet.hs view
@@ -19,6 +19,8 @@ -- Portability : non-portable (GHC extensions) -- -- 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 <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html Updating Stacks Using Change Sets> in the AWS CloudFormation User Guide.+--+-- module Network.AWS.CloudFormation.DescribeChangeSet ( -- * Creating a Request@@ -34,7 +36,6 @@ , DescribeChangeSetResponse -- * Response Lenses , drsCreationTime- , drsStatus , drsChanges , drsNotificationARNs , drsChangeSetName@@ -49,6 +50,7 @@ , drsTags , drsStackName , drsResponseStatus+ , drsStatus ) where import Network.AWS.CloudFormation.Types@@ -58,8 +60,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for the < DescribeChangeSet> action.+-- | The input for the 'DescribeChangeSet' action. --+--+-- -- /See:/ 'describeChangeSet' smart constructor. data DescribeChangeSet = DescribeChangeSet' { _desNextToken :: !(Maybe Text)@@ -71,11 +75,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'desNextToken'+-- * 'desNextToken' - A string (provided by the 'DescribeChangeSet' response output) that identifies the next page of information that you want to retrieve. ----- * 'desStackName'+-- * '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'+-- * 'desChangeSetName' - The name or Amazon Resource Name (ARN) of the change set that you want to describe. describeChangeSet :: Text -- ^ 'desChangeSetName' -> DescribeChangeSet@@ -86,7 +90,7 @@ , _desChangeSetName = pChangeSetName_ } --- | A string (provided by the < DescribeChangeSet> response output) that identifies the next page of information that you want to retrieve.+-- | A string (provided by the 'DescribeChangeSet' response output) that identifies the next page of information that you want to retrieve. desNextToken :: Lens' DescribeChangeSet (Maybe Text) desNextToken = lens _desNextToken (\ s a -> s{_desNextToken = a}); @@ -105,7 +109,7 @@ = receiveXMLWrapper "DescribeChangeSetResult" (\ s h x -> DescribeChangeSetResponse' <$>- (x .@? "CreationTime") <*> (x .@? "Status") <*>+ (x .@? "CreationTime") <*> (x .@? "Changes" .!@ mempty >>= may (parseXMLList "member")) <*>@@ -128,7 +132,8 @@ (x .@? "Tags" .!@ mempty >>= may (parseXMLList "member")) <*> (x .@? "StackName")- <*> (pure (fromEnum s)))+ <*> (pure (fromEnum s))+ <*> (x .@ "Status")) instance Hashable DescribeChangeSet @@ -149,12 +154,13 @@ "StackName" =: _desStackName, "ChangeSetName" =: _desChangeSetName] --- | The output for the < DescribeChangeSet> action.+-- | The output for the 'DescribeChangeSet' action. --+--+-- -- /See:/ 'describeChangeSetResponse' smart constructor. data DescribeChangeSetResponse = DescribeChangeSetResponse' { _drsCreationTime :: !(Maybe ISO8601)- , _drsStatus :: !(Maybe ChangeSetStatus) , _drsChanges :: !(Maybe [Change]) , _drsNotificationARNs :: !(Maybe [Text]) , _drsChangeSetName :: !(Maybe Text)@@ -169,50 +175,51 @@ , _drsTags :: !(Maybe [Tag]) , _drsStackName :: !(Maybe Text) , _drsResponseStatus :: !Int+ , _drsStatus :: !ChangeSetStatus } deriving (Eq,Read,Show,Data,Typeable,Generic) -- | 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'+-- * 'drsCreationTime' - The start time when the change set was created, in UTC. ----- * 'drsStatus'+-- * 'drsChanges' - A list of @Change@ structures that describes the resources AWS CloudFormation changes if you execute the change set. ----- * 'drsChanges'+-- * '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. ----- * 'drsNotificationARNs'+-- * 'drsChangeSetName' - The name of the change set. ----- * 'drsChangeSetName'+-- * '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. ----- * 'drsExecutionStatus'+-- * 'drsChangeSetId' - The ARN of the change set. ----- * 'drsChangeSetId'+-- * '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. ----- * 'drsNextToken'+-- * '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 <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html Parameter> data type. ----- * 'drsParameters'+-- * '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. ----- * 'drsStatusReason'+-- * 'drsStackId' - The ARN of the stack that is associated with the change set. ----- * 'drsStackId'+-- * 'drsDescription' - Information about the change set. ----- * 'drsDescription'+-- * 'drsCapabilities' - If you execute the change set, the list of capabilities that were explicitly acknowledged when the change set was created. ----- * 'drsCapabilities'+-- * 'drsTags' - If you execute the change set, the tags that will be associated with the stack. ----- * 'drsTags'+-- * 'drsStackName' - The name of the stack that is associated with the change set. ----- * 'drsStackName'+-- * 'drsResponseStatus' - -- | The response status code. ----- * 'drsResponseStatus'+-- * 'drsStatus' - The current status of the change set, such as @CREATE_IN_PROGRESS@ , @CREATE_COMPLETE@ , or @FAILED@ . describeChangeSetResponse :: Int -- ^ 'drsResponseStatus'+ -> ChangeSetStatus -- ^ 'drsStatus' -> DescribeChangeSetResponse-describeChangeSetResponse pResponseStatus_ =+describeChangeSetResponse pResponseStatus_ pStatus_ = DescribeChangeSetResponse' { _drsCreationTime = Nothing- , _drsStatus = Nothing , _drsChanges = Nothing , _drsNotificationARNs = Nothing , _drsChangeSetName = Nothing@@ -227,17 +234,14 @@ , _drsTags = Nothing , _drsStackName = Nothing , _drsResponseStatus = pResponseStatus_+ , _drsStatus = pStatus_ } -- | The start time when the change set was created, in UTC. drsCreationTime :: Lens' DescribeChangeSetResponse (Maybe UTCTime) drsCreationTime = lens _drsCreationTime (\ s a -> s{_drsCreationTime = a}) . mapping _Time; --- | The current status of the change set, such as 'CREATE_IN_PROGRESS', 'CREATE_COMPLETE', or 'FAILED'.-drsStatus :: Lens' DescribeChangeSetResponse (Maybe ChangeSetStatus)-drsStatus = lens _drsStatus (\ s a -> s{_drsStatus = a});---- | A list of 'Change' structures that describes the resources AWS CloudFormation changes if you execute the change set.+-- | A list of @Change@ structures that describes the resources AWS CloudFormation changes if you execute the change set. drsChanges :: Lens' DescribeChangeSetResponse [Change] drsChanges = lens _drsChanges (\ s a -> s{_drsChanges = a}) . _Default . _Coerce; @@ -249,7 +253,7 @@ drsChangeSetName :: Lens' DescribeChangeSetResponse (Maybe Text) drsChangeSetName = lens _drsChangeSetName (\ s a -> s{_drsChangeSetName = a}); --- | 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.+-- | 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. drsExecutionStatus :: Lens' DescribeChangeSetResponse (Maybe ExecutionStatus) drsExecutionStatus = lens _drsExecutionStatus (\ s a -> s{_drsExecutionStatus = a}); @@ -261,11 +265,11 @@ drsNextToken :: Lens' DescribeChangeSetResponse (Maybe Text) drsNextToken = lens _drsNextToken (\ s a -> s{_drsNextToken = a}); --- | A list of 'Parameter' structures that describes the input parameters and their values used to create the change set. For more information, see the <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html Parameter> data type.+-- | A list of @Parameter@ structures that describes the input parameters and their values used to create the change set. For more information, see the <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html Parameter> data type. drsParameters :: Lens' DescribeChangeSetResponse [Parameter] drsParameters = lens _drsParameters (\ s a -> s{_drsParameters = a}) . _Default . _Coerce; --- | 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.+-- | 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. drsStatusReason :: Lens' DescribeChangeSetResponse (Maybe Text) drsStatusReason = lens _drsStatusReason (\ s a -> s{_drsStatusReason = a}); @@ -289,8 +293,12 @@ drsStackName :: Lens' DescribeChangeSetResponse (Maybe Text) drsStackName = lens _drsStackName (\ s a -> s{_drsStackName = a}); --- | The response status code.+-- | -- | The response status code. drsResponseStatus :: Lens' DescribeChangeSetResponse Int drsResponseStatus = lens _drsResponseStatus (\ s a -> s{_drsResponseStatus = a});++-- | The current status of the change set, such as @CREATE_IN_PROGRESS@ , @CREATE_COMPLETE@ , or @FAILED@ .+drsStatus :: Lens' DescribeChangeSetResponse ChangeSetStatus+drsStatus = lens _drsStatus (\ s a -> s{_drsStatus = a}); instance NFData DescribeChangeSetResponse
gen/Network/AWS/CloudFormation/DescribeStackEvents.hs view
@@ -18,10 +18,10 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- Returns all stack related events for a specified stack in reverse chronological order. For more information about a stack\'s event history, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/concept-stack.html Stacks> in the AWS CloudFormation User Guide.+-- Returns all stack related events for a specified stack in reverse chronological order. For more information about a stack's event history, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/concept-stack.html Stacks> in the AWS CloudFormation User Guide. ----- You can list events for stacks that have failed to create or have been deleted by specifying the unique stack identifier (stack ID). --+-- -- This operation returns paginated results. module Network.AWS.CloudFormation.DescribeStackEvents (@@ -49,8 +49,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for < DescribeStackEvents> action.+-- | The input for 'DescribeStackEvents' action. --+--+-- -- /See:/ 'describeStackEvents' smart constructor. data DescribeStackEvents = DescribeStackEvents' { _dseNextToken :: !(Maybe Text)@@ -61,9 +63,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'dseNextToken'+-- * 'dseNextToken' - A string that identifies the next page of events that you want to retrieve. ----- * 'dseStackName'+-- * 'dseStackName' - The name or the unique stack ID that is associated with the stack, which are not always interchangeable: * Running stacks: You can specify either the stack's name or its unique stack ID. * Deleted stacks: You must specify the unique stack ID. Default: There is no default value. describeStackEvents :: DescribeStackEvents describeStackEvents =@@ -76,13 +78,7 @@ dseNextToken :: Lens' DescribeStackEvents (Maybe Text) dseNextToken = lens _dseNextToken (\ s a -> s{_dseNextToken = a}); --- | The name or the unique stack ID that is associated with the stack, which are not always interchangeable:------ - Running stacks: You can specify either the stack\'s name or its unique stack ID.------ - Deleted stacks: You must specify the unique stack ID.------ Default: There is no default value.+-- | The name or the unique stack ID that is associated with the stack, which are not always interchangeable: * Running stacks: You can specify either the stack's name or its unique stack ID. * Deleted stacks: You must specify the unique stack ID. Default: There is no default value. dseStackName :: Lens' DescribeStackEvents (Maybe Text) dseStackName = lens _dseStackName (\ s a -> s{_dseStackName = a}); @@ -124,8 +120,10 @@ "NextToken" =: _dseNextToken, "StackName" =: _dseStackName] --- | The output for a < DescribeStackEvents> action.+-- | The output for a 'DescribeStackEvents' action. --+--+-- -- /See:/ 'describeStackEventsResponse' smart constructor. data DescribeStackEventsResponse = DescribeStackEventsResponse' { _dsersNextToken :: !(Maybe Text)@@ -137,11 +135,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'dsersNextToken'+-- * 'dsersNextToken' - If the output exceeds 1 MB in size, a string that identifies the next page of events. If no additional page exists, this value is null. ----- * 'dsersStackEvents'+-- * 'dsersStackEvents' - A list of @StackEvents@ structures. ----- * 'dsersResponseStatus'+-- * 'dsersResponseStatus' - -- | The response status code. describeStackEventsResponse :: Int -- ^ 'dsersResponseStatus' -> DescribeStackEventsResponse@@ -156,11 +154,11 @@ dsersNextToken :: Lens' DescribeStackEventsResponse (Maybe Text) dsersNextToken = lens _dsersNextToken (\ s a -> s{_dsersNextToken = a}); --- | A list of 'StackEvents' structures.+-- | A list of @StackEvents@ structures. dsersStackEvents :: Lens' DescribeStackEventsResponse [StackEvent] dsersStackEvents = lens _dsersStackEvents (\ s a -> s{_dsersStackEvents = a}) . _Default . _Coerce; --- | The response status code.+-- | -- | The response status code. dsersResponseStatus :: Lens' DescribeStackEventsResponse Int dsersResponseStatus = lens _dsersResponseStatus (\ s a -> s{_dsersResponseStatus = a});
gen/Network/AWS/CloudFormation/DescribeStackResource.hs view
@@ -20,7 +20,9 @@ -- -- Returns a description of the specified resource in the specified stack. --+-- -- For deleted stacks, DescribeStackResource returns resource information for up to 90 days after the stack has been deleted.+-- module Network.AWS.CloudFormation.DescribeStackResource ( -- * Creating a Request@@ -45,8 +47,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for < DescribeStackResource> action.+-- | The input for 'DescribeStackResource' action. --+--+-- -- /See:/ 'describeStackResource' smart constructor. data DescribeStackResource = DescribeStackResource' { _dsrsStackName :: !Text@@ -57,9 +61,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'dsrsStackName'+-- * 'dsrsStackName' - The name or the unique stack ID that is associated with the stack, which are not always interchangeable: * Running stacks: You can specify either the stack's name or its unique stack ID. * Deleted stacks: You must specify the unique stack ID. Default: There is no default value. ----- * 'dsrsLogicalResourceId'+-- * 'dsrsLogicalResourceId' - The logical name of the resource as specified in the template. Default: There is no default value. describeStackResource :: Text -- ^ 'dsrsStackName' -> Text -- ^ 'dsrsLogicalResourceId'@@ -70,19 +74,11 @@ , _dsrsLogicalResourceId = pLogicalResourceId_ } --- | The name or the unique stack ID that is associated with the stack, which are not always interchangeable:------ - Running stacks: You can specify either the stack\'s name or its unique stack ID.------ - Deleted stacks: You must specify the unique stack ID.------ Default: There is no default value.+-- | The name or the unique stack ID that is associated with the stack, which are not always interchangeable: * Running stacks: You can specify either the stack's name or its unique stack ID. * Deleted stacks: You must specify the unique stack ID. Default: There is no default value. dsrsStackName :: Lens' DescribeStackResource Text dsrsStackName = lens _dsrsStackName (\ s a -> s{_dsrsStackName = a}); --- | The logical name of the resource as specified in the template.------ Default: There is no default value.+-- | The logical name of the resource as specified in the template. Default: There is no default value. dsrsLogicalResourceId :: Lens' DescribeStackResource Text dsrsLogicalResourceId = lens _dsrsLogicalResourceId (\ s a -> s{_dsrsLogicalResourceId = a}); @@ -115,8 +111,10 @@ "StackName" =: _dsrsStackName, "LogicalResourceId" =: _dsrsLogicalResourceId] --- | The output for a < DescribeStackResource> action.+-- | The output for a 'DescribeStackResource' action. --+--+-- -- /See:/ 'describeStackResourceResponse' smart constructor. data DescribeStackResourceResponse = DescribeStackResourceResponse' { _dsrrsStackResourceDetail :: !(Maybe StackResourceDetail)@@ -127,9 +125,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'dsrrsStackResourceDetail'+-- * 'dsrrsStackResourceDetail' - A @StackResourceDetail@ structure containing the description of the specified resource in the specified stack. ----- * 'dsrrsResponseStatus'+-- * 'dsrrsResponseStatus' - -- | The response status code. describeStackResourceResponse :: Int -- ^ 'dsrrsResponseStatus' -> DescribeStackResourceResponse@@ -139,11 +137,11 @@ , _dsrrsResponseStatus = pResponseStatus_ } --- | A 'StackResourceDetail' structure containing the description of the specified resource in the specified stack.+-- | A @StackResourceDetail@ structure containing the description of the specified resource in the specified stack. dsrrsStackResourceDetail :: Lens' DescribeStackResourceResponse (Maybe StackResourceDetail) dsrrsStackResourceDetail = lens _dsrrsStackResourceDetail (\ s a -> s{_dsrrsStackResourceDetail = a}); --- | The response status code.+-- | -- | The response status code. dsrrsResponseStatus :: Lens' DescribeStackResourceResponse Int dsrrsResponseStatus = lens _dsrrsResponseStatus (\ s a -> s{_dsrrsResponseStatus = a});
gen/Network/AWS/CloudFormation/DescribeStackResources.hs view
@@ -18,15 +18,13 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- Returns AWS resource descriptions for running and deleted stacks. If 'StackName' is specified, all the associated resources that are part of the stack are returned. If 'PhysicalResourceId' is specified, the associated resources of the stack that the resource belongs to are returned.+-- Returns AWS resource descriptions for running and deleted stacks. If @StackName@ is specified, all the associated resources that are part of the stack are returned. If @PhysicalResourceId@ is specified, the associated resources of the stack that the resource belongs to are returned. ----- Only the first 100 resources will be returned. If your stack has more resources than this, you should use 'ListStackResources' instead. ----- For deleted stacks, 'DescribeStackResources' returns resource information for up to 90 days after the stack has been deleted.+-- For deleted stacks, @DescribeStackResources@ returns resource information for up to 90 days after the stack has been deleted. ----- You must specify either 'StackName' or 'PhysicalResourceId', but not both. In addition, you can specify 'LogicalResourceId' to filter the returned result. For more information about resources, the 'LogicalResourceId' and 'PhysicalResourceId', go to the <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/ AWS CloudFormation User Guide>.+-- You must specify either @StackName@ or @PhysicalResourceId@ , but not both. In addition, you can specify @LogicalResourceId@ to filter the returned result. For more information about resources, the @LogicalResourceId@ and @PhysicalResourceId@ , go to the <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/ AWS CloudFormation User Guide> . ----- A 'ValidationError' is returned if you specify both 'StackName' and 'PhysicalResourceId' in the same request. module Network.AWS.CloudFormation.DescribeStackResources ( -- * Creating a Request@@ -52,8 +50,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for < DescribeStackResources> action.+-- | The input for 'DescribeStackResources' action. --+--+-- -- /See:/ 'describeStackResources' smart constructor. data DescribeStackResources = DescribeStackResources' { _dsrLogicalResourceId :: !(Maybe Text)@@ -65,11 +65,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'dsrLogicalResourceId'+-- * 'dsrLogicalResourceId' - The logical name of the resource as specified in the template. Default: There is no default value. ----- * 'dsrPhysicalResourceId'+-- * 'dsrPhysicalResourceId' - The name or unique identifier that corresponds to a physical instance ID of a resource supported by AWS CloudFormation. For example, for an Amazon Elastic Compute Cloud (EC2) instance, @PhysicalResourceId@ corresponds to the @InstanceId@ . You can pass the EC2 @InstanceId@ to @DescribeStackResources@ to find which stack the instance belongs to and what other resources are part of the stack. Required: Conditional. If you do not specify @PhysicalResourceId@ , you must specify @StackName@ . Default: There is no default value. ----- * 'dsrStackName'+-- * 'dsrStackName' - The name or the unique stack ID that is associated with the stack, which are not always interchangeable: * Running stacks: You can specify either the stack's name or its unique stack ID. * Deleted stacks: You must specify the unique stack ID. Default: There is no default value. Required: Conditional. If you do not specify @StackName@ , you must specify @PhysicalResourceId@ . describeStackResources :: DescribeStackResources describeStackResources =@@ -79,31 +79,15 @@ , _dsrStackName = Nothing } --- | The logical name of the resource as specified in the template.------ Default: There is no default value.+-- | The logical name of the resource as specified in the template. Default: There is no default value. dsrLogicalResourceId :: Lens' DescribeStackResources (Maybe Text) dsrLogicalResourceId = lens _dsrLogicalResourceId (\ s a -> s{_dsrLogicalResourceId = a}); --- | The name or unique identifier that corresponds to a physical instance ID of a resource supported by AWS CloudFormation.------ For example, for an Amazon Elastic Compute Cloud (EC2) instance, 'PhysicalResourceId' corresponds to the 'InstanceId'. You can pass the EC2 'InstanceId' to 'DescribeStackResources' to find which stack the instance belongs to and what other resources are part of the stack.------ Required: Conditional. If you do not specify 'PhysicalResourceId', you must specify 'StackName'.------ Default: There is no default value.+-- | The name or unique identifier that corresponds to a physical instance ID of a resource supported by AWS CloudFormation. For example, for an Amazon Elastic Compute Cloud (EC2) instance, @PhysicalResourceId@ corresponds to the @InstanceId@ . You can pass the EC2 @InstanceId@ to @DescribeStackResources@ to find which stack the instance belongs to and what other resources are part of the stack. Required: Conditional. If you do not specify @PhysicalResourceId@ , you must specify @StackName@ . Default: There is no default value. dsrPhysicalResourceId :: Lens' DescribeStackResources (Maybe Text) dsrPhysicalResourceId = lens _dsrPhysicalResourceId (\ s a -> s{_dsrPhysicalResourceId = a}); --- | The name or the unique stack ID that is associated with the stack, which are not always interchangeable:------ - Running stacks: You can specify either the stack\'s name or its unique stack ID.------ - Deleted stacks: You must specify the unique stack ID.------ Default: There is no default value.------ Required: Conditional. If you do not specify 'StackName', you must specify 'PhysicalResourceId'.+-- | The name or the unique stack ID that is associated with the stack, which are not always interchangeable: * Running stacks: You can specify either the stack's name or its unique stack ID. * Deleted stacks: You must specify the unique stack ID. Default: There is no default value. Required: Conditional. If you do not specify @StackName@ , you must specify @PhysicalResourceId@ . dsrStackName :: Lens' DescribeStackResources (Maybe Text) dsrStackName = lens _dsrStackName (\ s a -> s{_dsrStackName = a}); @@ -139,8 +123,10 @@ "PhysicalResourceId" =: _dsrPhysicalResourceId, "StackName" =: _dsrStackName] --- | The output for a < DescribeStackResources> action.+-- | The output for a 'DescribeStackResources' action. --+--+-- -- /See:/ 'describeStackResourcesResponse' smart constructor. data DescribeStackResourcesResponse = DescribeStackResourcesResponse' { _dsrsrsStackResources :: !(Maybe [StackResource])@@ -151,9 +137,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'dsrsrsStackResources'+-- * 'dsrsrsStackResources' - A list of @StackResource@ structures. ----- * 'dsrsrsResponseStatus'+-- * 'dsrsrsResponseStatus' - -- | The response status code. describeStackResourcesResponse :: Int -- ^ 'dsrsrsResponseStatus' -> DescribeStackResourcesResponse@@ -163,11 +149,11 @@ , _dsrsrsResponseStatus = pResponseStatus_ } --- | A list of 'StackResource' structures.+-- | A list of @StackResource@ structures. dsrsrsStackResources :: Lens' DescribeStackResourcesResponse [StackResource] dsrsrsStackResources = lens _dsrsrsStackResources (\ s a -> s{_dsrsrsStackResources = a}) . _Default . _Coerce; --- | The response status code.+-- | -- | The response status code. dsrsrsResponseStatus :: Lens' DescribeStackResourcesResponse Int dsrsrsResponseStatus = lens _dsrsrsResponseStatus (\ s a -> s{_dsrsrsResponseStatus = a});
gen/Network/AWS/CloudFormation/DescribeStacks.hs view
@@ -20,6 +20,8 @@ -- -- Returns the description for the specified stack; if no stack name was specified, then it returns the description for all the stacks created. --+--+-- -- This operation returns paginated results. module Network.AWS.CloudFormation.DescribeStacks (@@ -47,8 +49,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for < DescribeStacks> action.+-- | The input for 'DescribeStacks' action. --+--+-- -- /See:/ 'describeStacks' smart constructor. data DescribeStacks = DescribeStacks' { _dNextToken :: !(Maybe Text)@@ -59,9 +63,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'dNextToken'+-- * 'dNextToken' - A string that identifies the next page of stacks that you want to retrieve. ----- * 'dStackName'+-- * 'dStackName' - The name or the unique stack ID that is associated with the stack, which are not always interchangeable: * Running stacks: You can specify either the stack's name or its unique stack ID. * Deleted stacks: You must specify the unique stack ID. Default: There is no default value. describeStacks :: DescribeStacks describeStacks =@@ -74,13 +78,7 @@ dNextToken :: Lens' DescribeStacks (Maybe Text) dNextToken = lens _dNextToken (\ s a -> s{_dNextToken = a}); --- | The name or the unique stack ID that is associated with the stack, which are not always interchangeable:------ - Running stacks: You can specify either the stack\'s name or its unique stack ID.------ - Deleted stacks: You must specify the unique stack ID.------ Default: There is no default value.+-- | The name or the unique stack ID that is associated with the stack, which are not always interchangeable: * Running stacks: You can specify either the stack's name or its unique stack ID. * Deleted stacks: You must specify the unique stack ID. Default: There is no default value. dStackName :: Lens' DescribeStacks (Maybe Text) dStackName = lens _dStackName (\ s a -> s{_dStackName = a}); @@ -121,8 +119,10 @@ "NextToken" =: _dNextToken, "StackName" =: _dStackName] --- | The output for a < DescribeStacks> action.+-- | The output for a 'DescribeStacks' action. --+--+-- -- /See:/ 'describeStacksResponse' smart constructor. data DescribeStacksResponse = DescribeStacksResponse' { _dsrsNextToken :: !(Maybe Text)@@ -134,11 +134,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'dsrsNextToken'+-- * 'dsrsNextToken' - If the output exceeds 1 MB in size, a string that identifies the next page of stacks. If no additional page exists, this value is null. ----- * 'dsrsStacks'+-- * 'dsrsStacks' - A list of stack structures. ----- * 'dsrsResponseStatus'+-- * 'dsrsResponseStatus' - -- | The response status code. describeStacksResponse :: Int -- ^ 'dsrsResponseStatus' -> DescribeStacksResponse@@ -157,7 +157,7 @@ dsrsStacks :: Lens' DescribeStacksResponse [Stack] dsrsStacks = lens _dsrsStacks (\ s a -> s{_dsrsStacks = a}) . _Default . _Coerce; --- | The response status code.+-- | -- | The response status code. dsrsResponseStatus :: Lens' DescribeStacksResponse Int dsrsResponseStatus = lens _dsrsResponseStatus (\ s a -> s{_dsrsResponseStatus = a});
gen/Network/AWS/CloudFormation/EstimateTemplateCost.hs view
@@ -19,6 +19,8 @@ -- Portability : non-portable (GHC extensions) -- -- Returns the estimated monthly cost of a template. The return value is an AWS Simple Monthly Calculator URL with a query string that describes the resources required to run the template.+--+-- module Network.AWS.CloudFormation.EstimateTemplateCost ( -- * Creating a Request@@ -44,8 +46,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for an < EstimateTemplateCost> action.+-- | The input for an 'EstimateTemplateCost' action. --+--+-- -- /See:/ 'estimateTemplateCost' smart constructor. data EstimateTemplateCost = EstimateTemplateCost' { _etcParameters :: !(Maybe [Parameter])@@ -57,11 +61,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'etcParameters'+-- * 'etcParameters' - A list of @Parameter@ structures that specify input parameters. ----- * 'etcTemplateBody'+-- * 'etcTemplateBody' - Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.) Conditional: You must pass @TemplateBody@ or @TemplateURL@ . If both are passed, only @TemplateBody@ is used. ----- * 'etcTemplateURL'+-- * 'etcTemplateURL' - Location of file containing the template body. The URL must point to a template that is located in an Amazon S3 bucket. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must pass @TemplateURL@ or @TemplateBody@ . If both are passed, only @TemplateBody@ is used. estimateTemplateCost :: EstimateTemplateCost estimateTemplateCost =@@ -71,19 +75,15 @@ , _etcTemplateURL = Nothing } --- | A list of 'Parameter' structures that specify input parameters.+-- | A list of @Parameter@ structures that specify input parameters. etcParameters :: Lens' EstimateTemplateCost [Parameter] etcParameters = lens _etcParameters (\ s a -> s{_etcParameters = a}) . _Default . _Coerce; --- | Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.)------ Conditional: You must pass 'TemplateBody' or 'TemplateURL'. If both are passed, only 'TemplateBody' is used.+-- | Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.) Conditional: You must pass @TemplateBody@ or @TemplateURL@ . If both are passed, only @TemplateBody@ is used. etcTemplateBody :: Lens' EstimateTemplateCost (Maybe Text) etcTemplateBody = lens _etcTemplateBody (\ s a -> s{_etcTemplateBody = a}); --- | Location of file containing the template body. The URL must point to a template that is located in an Amazon S3 bucket. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.------ Conditional: You must pass 'TemplateURL' or 'TemplateBody'. If both are passed, only 'TemplateBody' is used.+-- | Location of file containing the template body. The URL must point to a template that is located in an Amazon S3 bucket. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must pass @TemplateURL@ or @TemplateBody@ . If both are passed, only @TemplateBody@ is used. etcTemplateURL :: Lens' EstimateTemplateCost (Maybe Text) etcTemplateURL = lens _etcTemplateURL (\ s a -> s{_etcTemplateURL = a}); @@ -117,8 +117,10 @@ "TemplateBody" =: _etcTemplateBody, "TemplateURL" =: _etcTemplateURL] --- | The output for a < EstimateTemplateCost> action.+-- | The output for a 'EstimateTemplateCost' action. --+--+-- -- /See:/ 'estimateTemplateCostResponse' smart constructor. data EstimateTemplateCostResponse = EstimateTemplateCostResponse' { _etcrsURL :: !(Maybe Text)@@ -129,9 +131,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'etcrsURL'+-- * 'etcrsURL' - An AWS Simple Monthly Calculator URL with a query string that describes the resources required to run the template. ----- * 'etcrsResponseStatus'+-- * 'etcrsResponseStatus' - -- | The response status code. estimateTemplateCostResponse :: Int -- ^ 'etcrsResponseStatus' -> EstimateTemplateCostResponse@@ -145,7 +147,7 @@ etcrsURL :: Lens' EstimateTemplateCostResponse (Maybe Text) etcrsURL = lens _etcrsURL (\ s a -> s{_etcrsURL = a}); --- | The response status code.+-- | -- | The response status code. etcrsResponseStatus :: Lens' EstimateTemplateCostResponse Int etcrsResponseStatus = lens _etcrsResponseStatus (\ s a -> s{_etcrsResponseStatus = a});
gen/Network/AWS/CloudFormation/ExecuteChangeSet.hs view
@@ -18,11 +18,13 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- Updates a stack using the input information that was provided when the specified change set was created. After the call successfully completes, AWS CloudFormation starts updating the stack. Use the < DescribeStacks> action to view the status of the update.+-- Updates a stack using the input information that was provided when the specified change set was created. After the call successfully completes, AWS CloudFormation starts updating the stack. Use the 'DescribeStacks' action to view the status of the update. ----- When you execute a change set, AWS CloudFormation deletes all other change sets associated with the stack because they aren\'t valid for the updated stack. ----- If a stack policy is associated with the stack, AWS CloudFormation enforces the policy during the update. You can\'t specify a temporary stack policy that overrides the current policy.+-- When you execute a change set, AWS CloudFormation deletes all other change sets associated with the stack because they aren't valid for the updated stack.+--+-- If a stack policy is associated with the stack, AWS CloudFormation enforces the policy during the update. You can't specify a temporary stack policy that overrides the current policy.+-- module Network.AWS.CloudFormation.ExecuteChangeSet ( -- * Creating a Request@@ -46,8 +48,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for the < ExecuteChangeSet> action.+-- | The input for the 'ExecuteChangeSet' action. --+--+-- -- /See:/ 'executeChangeSet' smart constructor. data ExecuteChangeSet = ExecuteChangeSet' { _ecsStackName :: !(Maybe Text)@@ -58,9 +62,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'ecsStackName'+-- * 'ecsStackName' - If you specified the name of a change set, specify the stack name or ID (ARN) that is associated with the change set you want to execute. ----- * 'ecsChangeSetName'+-- * 'ecsChangeSetName' - The name or ARN of the change set that you want use to update the specified stack. executeChangeSet :: Text -- ^ 'ecsChangeSetName' -> ExecuteChangeSet@@ -104,8 +108,10 @@ "StackName" =: _ecsStackName, "ChangeSetName" =: _ecsChangeSetName] --- | The output for the < ExecuteChangeSet> action.+-- | The output for the 'ExecuteChangeSet' action. --+--+-- -- /See:/ 'executeChangeSetResponse' smart constructor. newtype ExecuteChangeSetResponse = ExecuteChangeSetResponse' { _ecsrsResponseStatus :: Int@@ -115,7 +121,7 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'ecsrsResponseStatus'+-- * 'ecsrsResponseStatus' - -- | The response status code. executeChangeSetResponse :: Int -- ^ 'ecsrsResponseStatus' -> ExecuteChangeSetResponse@@ -124,7 +130,7 @@ { _ecsrsResponseStatus = pResponseStatus_ } --- | The response status code.+-- | -- | The response status code. ecsrsResponseStatus :: Lens' ExecuteChangeSetResponse Int ecsrsResponseStatus = lens _ecsrsResponseStatus (\ s a -> s{_ecsrsResponseStatus = a});
gen/Network/AWS/CloudFormation/GetStackPolicy.hs view
@@ -18,7 +18,9 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- Returns the stack policy for a specified stack. If a stack doesn\'t have a policy, a null value is returned.+-- Returns the stack policy for a specified stack. If a stack doesn't have a policy, a null value is returned.+--+-- module Network.AWS.CloudFormation.GetStackPolicy ( -- * Creating a Request@@ -42,8 +44,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for the < GetStackPolicy> action.+-- | The input for the 'GetStackPolicy' action. --+--+-- -- /See:/ 'getStackPolicy' smart constructor. newtype GetStackPolicy = GetStackPolicy' { _gspStackName :: Text@@ -53,7 +57,7 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'gspStackName'+-- * 'gspStackName' - The name or unique stack ID that is associated with the stack whose policy you want to get. getStackPolicy :: Text -- ^ 'gspStackName' -> GetStackPolicy@@ -92,8 +96,10 @@ "Version" =: ("2010-05-15" :: ByteString), "StackName" =: _gspStackName] --- | The output for the < GetStackPolicy> action.+-- | The output for the 'GetStackPolicy' action. --+--+-- -- /See:/ 'getStackPolicyResponse' smart constructor. data GetStackPolicyResponse = GetStackPolicyResponse' { _gsprsStackPolicyBody :: !(Maybe Text)@@ -104,9 +110,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'gsprsStackPolicyBody'+-- * 'gsprsStackPolicyBody' - Structure containing the stack policy body. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/protect-stack-resources.html Prevent Updates to Stack Resources> in the AWS CloudFormation User Guide.) ----- * 'gsprsResponseStatus'+-- * 'gsprsResponseStatus' - -- | The response status code. getStackPolicyResponse :: Int -- ^ 'gsprsResponseStatus' -> GetStackPolicyResponse@@ -120,7 +126,7 @@ gsprsStackPolicyBody :: Lens' GetStackPolicyResponse (Maybe Text) gsprsStackPolicyBody = lens _gsprsStackPolicyBody (\ s a -> s{_gsprsStackPolicyBody = a}); --- | The response status code.+-- | -- | The response status code. gsprsResponseStatus :: Lens' GetStackPolicyResponse Int gsprsResponseStatus = lens _gsprsResponseStatus (\ s a -> s{_gsprsResponseStatus = a});
gen/Network/AWS/CloudFormation/GetTemplate.hs view
@@ -20,21 +20,24 @@ -- -- Returns the template body for a specified stack. You can get the template for running or deleted stacks. --+-- -- For deleted stacks, GetTemplate returns the template for up to 90 days after the stack has been deleted. ----- If the template does not exist, a 'ValidationError' is returned. module Network.AWS.CloudFormation.GetTemplate ( -- * Creating a Request getTemplate , GetTemplate -- * Request Lenses+ , gtChangeSetName+ , gtTemplateStage , gtStackName -- * Destructuring the Response , getTemplateResponse , GetTemplateResponse -- * Response Lenses+ , gtrsStagesAvailable , gtrsTemplateBody , gtrsResponseStatus ) where@@ -46,34 +49,45 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for a < GetTemplate> action.+-- | The input for a 'GetTemplate' action. --+--+-- -- /See:/ 'getTemplate' smart constructor.-newtype GetTemplate = GetTemplate'- { _gtStackName :: Text+data GetTemplate = GetTemplate'+ { _gtChangeSetName :: !(Maybe Text)+ , _gtTemplateStage :: !(Maybe TemplateStage)+ , _gtStackName :: !(Maybe Text) } deriving (Eq,Read,Show,Data,Typeable,Generic) -- | Creates a value of 'GetTemplate' with the minimum fields required to make a request. -- -- Use one of the following lenses to modify other fields as desired: ----- * 'gtStackName'+-- * 'gtChangeSetName' - The name or Amazon Resource Name (ARN) of a change set for which AWS CloudFormation returns the associated template. If you specify a name, you must also specify the @StackName@ .+--+-- * 'gtTemplateStage' - For templates that include transforms, the stage of the template that AWS CloudFormation returns. To get the user-submitted template, specify @Original@ . To get the template after AWS CloudFormation has processed all transforms, specify @Processed@ . If the template doesn't include transforms, @Original@ and @Processed@ return the same template. By default, AWS CloudFormation specifies @Original@ .+--+-- * 'gtStackName' - The name or the unique stack ID that is associated with the stack, which are not always interchangeable: * Running stacks: You can specify either the stack's name or its unique stack ID. * Deleted stacks: You must specify the unique stack ID. Default: There is no default value. getTemplate- :: Text -- ^ 'gtStackName'- -> GetTemplate-getTemplate pStackName_ =+ :: GetTemplate+getTemplate = GetTemplate'- { _gtStackName = pStackName_+ { _gtChangeSetName = Nothing+ , _gtTemplateStage = Nothing+ , _gtStackName = Nothing } --- | The name or the unique stack ID that is associated with the stack, which are not always interchangeable:------ - Running stacks: You can specify either the stack\'s name or its unique stack ID.------ - Deleted stacks: You must specify the unique stack ID.------ Default: There is no default value.-gtStackName :: Lens' GetTemplate Text+-- | The name or Amazon Resource Name (ARN) of a change set for which AWS CloudFormation returns the associated template. If you specify a name, you must also specify the @StackName@ .+gtChangeSetName :: Lens' GetTemplate (Maybe Text)+gtChangeSetName = lens _gtChangeSetName (\ s a -> s{_gtChangeSetName = a});++-- | For templates that include transforms, the stage of the template that AWS CloudFormation returns. To get the user-submitted template, specify @Original@ . To get the template after AWS CloudFormation has processed all transforms, specify @Processed@ . If the template doesn't include transforms, @Original@ and @Processed@ return the same template. By default, AWS CloudFormation specifies @Original@ .+gtTemplateStage :: Lens' GetTemplate (Maybe TemplateStage)+gtTemplateStage = lens _gtTemplateStage (\ s a -> s{_gtTemplateStage = a});++-- | The name or the unique stack ID that is associated with the stack, which are not always interchangeable: * Running stacks: You can specify either the stack's name or its unique stack ID. * Deleted stacks: You must specify the unique stack ID. Default: There is no default value.+gtStackName :: Lens' GetTemplate (Maybe Text) gtStackName = lens _gtStackName (\ s a -> s{_gtStackName = a}); instance AWSRequest GetTemplate where@@ -83,7 +97,10 @@ = receiveXMLWrapper "GetTemplateResult" (\ s h x -> GetTemplateResponse' <$>- (x .@? "TemplateBody") <*> (pure (fromEnum s)))+ (x .@? "StagesAvailable" .!@ mempty >>=+ may (parseXMLList "member"))+ <*> (x .@? "TemplateBody")+ <*> (pure (fromEnum s))) instance Hashable GetTemplate @@ -100,37 +117,49 @@ = mconcat ["Action" =: ("GetTemplate" :: ByteString), "Version" =: ("2010-05-15" :: ByteString),+ "ChangeSetName" =: _gtChangeSetName,+ "TemplateStage" =: _gtTemplateStage, "StackName" =: _gtStackName] --- | The output for < GetTemplate> action.+-- | The output for 'GetTemplate' action. --+--+-- -- /See:/ 'getTemplateResponse' smart constructor. data GetTemplateResponse = GetTemplateResponse'- { _gtrsTemplateBody :: !(Maybe Text)- , _gtrsResponseStatus :: !Int+ { _gtrsStagesAvailable :: !(Maybe [TemplateStage])+ , _gtrsTemplateBody :: !(Maybe Text)+ , _gtrsResponseStatus :: !Int } deriving (Eq,Read,Show,Data,Typeable,Generic) -- | Creates a value of 'GetTemplateResponse' with the minimum fields required to make a request. -- -- Use one of the following lenses to modify other fields as desired: ----- * 'gtrsTemplateBody'+-- * 'gtrsStagesAvailable' - The stage of the template that you can retrieve. For stacks, the @Original@ and @Processed@ templates are always available. For change sets, the @Original@ template is always available. After AWS CloudFormation finishes creating the change set, the @Processed@ template becomes available. ----- * 'gtrsResponseStatus'+-- * 'gtrsTemplateBody' - Structure containing the template body. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.) AWS CloudFormation returns the same template that was used when the stack was created.+--+-- * 'gtrsResponseStatus' - -- | The response status code. getTemplateResponse :: Int -- ^ 'gtrsResponseStatus' -> GetTemplateResponse getTemplateResponse pResponseStatus_ = GetTemplateResponse'- { _gtrsTemplateBody = Nothing+ { _gtrsStagesAvailable = Nothing+ , _gtrsTemplateBody = Nothing , _gtrsResponseStatus = pResponseStatus_ } --- | Structure containing the template body. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.)+-- | The stage of the template that you can retrieve. For stacks, the @Original@ and @Processed@ templates are always available. For change sets, the @Original@ template is always available. After AWS CloudFormation finishes creating the change set, the @Processed@ template becomes available.+gtrsStagesAvailable :: Lens' GetTemplateResponse [TemplateStage]+gtrsStagesAvailable = lens _gtrsStagesAvailable (\ s a -> s{_gtrsStagesAvailable = a}) . _Default . _Coerce;++-- | Structure containing the template body. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.) AWS CloudFormation returns the same template that was used when the stack was created. gtrsTemplateBody :: Lens' GetTemplateResponse (Maybe Text) gtrsTemplateBody = lens _gtrsTemplateBody (\ s a -> s{_gtrsTemplateBody = a}); --- | The response status code.+-- | -- | The response status code. gtrsResponseStatus :: Lens' GetTemplateResponse Int gtrsResponseStatus = lens _gtrsResponseStatus (\ s a -> s{_gtrsResponseStatus = a});
gen/Network/AWS/CloudFormation/GetTemplateSummary.hs view
@@ -18,11 +18,13 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- Returns information about a new or existing template. The 'GetTemplateSummary' action is useful for viewing parameter information, such as default parameter values and parameter types, before you create or update a stack.+-- Returns information about a new or existing template. The @GetTemplateSummary@ action is useful for viewing parameter information, such as default parameter values and parameter types, before you create or update a stack. ----- You can use the 'GetTemplateSummary' action when you submit a template, or you can get template information for a running or deleted stack. ----- For deleted stacks, 'GetTemplateSummary' returns the template information for up to 90 days after the stack has been deleted. If the template does not exist, a 'ValidationError' is returned.+-- You can use the @GetTemplateSummary@ action when you submit a template, or you can get template information for a running or deleted stack.+--+-- For deleted stacks, @GetTemplateSummary@ returns the template information for up to 90 days after the stack has been deleted. If the template does not exist, a @ValidationError@ is returned.+-- module Network.AWS.CloudFormation.GetTemplateSummary ( -- * Creating a Request@@ -37,6 +39,7 @@ , getTemplateSummaryResponse , GetTemplateSummaryResponse -- * Response Lenses+ , gtsrsDeclaredTransforms , gtsrsVersion , gtsrsCapabilitiesReason , gtsrsParameters@@ -54,8 +57,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for the < GetTemplateSummary> action.+-- | The input for the 'GetTemplateSummary' action. --+--+-- -- /See:/ 'getTemplateSummary' smart constructor. data GetTemplateSummary = GetTemplateSummary' { _gtsTemplateBody :: !(Maybe Text)@@ -67,11 +72,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'gtsTemplateBody'+-- * 'gtsTemplateBody' - Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information about templates, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must specify only one of the following parameters: @StackName@ , @TemplateBody@ , or @TemplateURL@ . ----- * 'gtsTemplateURL'+-- * 'gtsTemplateURL' - Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information about templates, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must specify only one of the following parameters: @StackName@ , @TemplateBody@ , or @TemplateURL@ . ----- * 'gtsStackName'+-- * 'gtsStackName' - The name or the stack ID that is associated with the stack, which are not always interchangeable. For running stacks, you can specify either the stack's name or its unique stack ID. For deleted stack, you must specify the unique stack ID. Conditional: You must specify only one of the following parameters: @StackName@ , @TemplateBody@ , or @TemplateURL@ . getTemplateSummary :: GetTemplateSummary getTemplateSummary =@@ -81,21 +86,15 @@ , _gtsStackName = Nothing } --- | Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information about templates, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.------ Conditional: You must specify only one of the following parameters: 'StackName', 'TemplateBody', or 'TemplateURL'.+-- | Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information about templates, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must specify only one of the following parameters: @StackName@ , @TemplateBody@ , or @TemplateURL@ . gtsTemplateBody :: Lens' GetTemplateSummary (Maybe Text) gtsTemplateBody = lens _gtsTemplateBody (\ s a -> s{_gtsTemplateBody = a}); --- | Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information about templates, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.------ Conditional: You must specify only one of the following parameters: 'StackName', 'TemplateBody', or 'TemplateURL'.+-- | Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information about templates, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must specify only one of the following parameters: @StackName@ , @TemplateBody@ , or @TemplateURL@ . gtsTemplateURL :: Lens' GetTemplateSummary (Maybe Text) gtsTemplateURL = lens _gtsTemplateURL (\ s a -> s{_gtsTemplateURL = a}); --- | The name or the stack ID that is associated with the stack, which are not always interchangeable. For running stacks, you can specify either the stack\'s name or its unique stack ID. For deleted stack, you must specify the unique stack ID.------ Conditional: You must specify only one of the following parameters: 'StackName', 'TemplateBody', or 'TemplateURL'.+-- | The name or the stack ID that is associated with the stack, which are not always interchangeable. For running stacks, you can specify either the stack's name or its unique stack ID. For deleted stack, you must specify the unique stack ID. Conditional: You must specify only one of the following parameters: @StackName@ , @TemplateBody@ , or @TemplateURL@ . gtsStackName :: Lens' GetTemplateSummary (Maybe Text) gtsStackName = lens _gtsStackName (\ s a -> s{_gtsStackName = a}); @@ -107,7 +106,10 @@ = receiveXMLWrapper "GetTemplateSummaryResult" (\ s h x -> GetTemplateSummaryResponse' <$>- (x .@? "Version") <*> (x .@? "CapabilitiesReason")+ (x .@? "DeclaredTransforms" .!@ mempty >>=+ may (parseXMLList "member"))+ <*> (x .@? "Version")+ <*> (x .@? "CapabilitiesReason") <*> (x .@? "Parameters" .!@ mempty >>= may (parseXMLList "member"))@@ -140,11 +142,14 @@ "TemplateURL" =: _gtsTemplateURL, "StackName" =: _gtsStackName] --- | The output for the < GetTemplateSummary> action.+-- | The output for the 'GetTemplateSummary' action. --+--+-- -- /See:/ 'getTemplateSummaryResponse' smart constructor. data GetTemplateSummaryResponse = GetTemplateSummaryResponse'- { _gtsrsVersion :: !(Maybe Text)+ { _gtsrsDeclaredTransforms :: !(Maybe [Text])+ , _gtsrsVersion :: !(Maybe Text) , _gtsrsCapabilitiesReason :: !(Maybe Text) , _gtsrsParameters :: !(Maybe [ParameterDeclaration]) , _gtsrsMetadata :: !(Maybe Text)@@ -158,27 +163,30 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'gtsrsVersion'+-- * 'gtsrsDeclaredTransforms' - A list of the transforms that are declared in the template. ----- * 'gtsrsCapabilitiesReason'+-- * 'gtsrsVersion' - The AWS template format version, which identifies the capabilities of the template. ----- * 'gtsrsParameters'+-- * 'gtsrsCapabilitiesReason' - The list of resources that generated the values in the @Capabilities@ response element. ----- * 'gtsrsMetadata'+-- * 'gtsrsParameters' - A list of parameter declarations that describe various properties for each parameter. ----- * 'gtsrsDescription'+-- * 'gtsrsMetadata' - The value that is defined for the @Metadata@ property of the template. ----- * 'gtsrsCapabilities'+-- * 'gtsrsDescription' - The value that is defined in the @Description@ property of the template. ----- * 'gtsrsResourceTypes'+-- * 'gtsrsCapabilities' - The capabilities found within the template. If your template contains IAM resources, you must specify the CAPABILITY_IAM or CAPABILITY_NAMED_IAM value for this parameter when you use the 'CreateStack' or 'UpdateStack' actions with your template; otherwise, those actions return an InsufficientCapabilities error. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates> . ----- * 'gtsrsResponseStatus'+-- * 'gtsrsResourceTypes' - A list of all the template resource types that are defined in the template, such as @AWS::EC2::Instance@ , @AWS::Dynamo::Table@ , and @Custom::MyCustomInstance@ .+--+-- * 'gtsrsResponseStatus' - -- | The response status code. getTemplateSummaryResponse :: Int -- ^ 'gtsrsResponseStatus' -> GetTemplateSummaryResponse getTemplateSummaryResponse pResponseStatus_ = GetTemplateSummaryResponse'- { _gtsrsVersion = Nothing+ { _gtsrsDeclaredTransforms = Nothing+ , _gtsrsVersion = Nothing , _gtsrsCapabilitiesReason = Nothing , _gtsrsParameters = Nothing , _gtsrsMetadata = Nothing@@ -188,11 +196,15 @@ , _gtsrsResponseStatus = pResponseStatus_ } +-- | A list of the transforms that are declared in the template.+gtsrsDeclaredTransforms :: Lens' GetTemplateSummaryResponse [Text]+gtsrsDeclaredTransforms = lens _gtsrsDeclaredTransforms (\ s a -> s{_gtsrsDeclaredTransforms = a}) . _Default . _Coerce;+ -- | The AWS template format version, which identifies the capabilities of the template. gtsrsVersion :: Lens' GetTemplateSummaryResponse (Maybe Text) gtsrsVersion = lens _gtsrsVersion (\ s a -> s{_gtsrsVersion = a}); --- | The list of resources that generated the values in the 'Capabilities' response element.+-- | The list of resources that generated the values in the @Capabilities@ response element. gtsrsCapabilitiesReason :: Lens' GetTemplateSummaryResponse (Maybe Text) gtsrsCapabilitiesReason = lens _gtsrsCapabilitiesReason (\ s a -> s{_gtsrsCapabilitiesReason = a}); @@ -200,25 +212,23 @@ gtsrsParameters :: Lens' GetTemplateSummaryResponse [ParameterDeclaration] gtsrsParameters = lens _gtsrsParameters (\ s a -> s{_gtsrsParameters = a}) . _Default . _Coerce; --- | The value that is defined for the 'Metadata' property of the template.+-- | The value that is defined for the @Metadata@ property of the template. gtsrsMetadata :: Lens' GetTemplateSummaryResponse (Maybe Text) gtsrsMetadata = lens _gtsrsMetadata (\ s a -> s{_gtsrsMetadata = a}); --- | The value that is defined in the 'Description' property of the template.+-- | The value that is defined in the @Description@ property of the template. gtsrsDescription :: Lens' GetTemplateSummaryResponse (Maybe Text) gtsrsDescription = lens _gtsrsDescription (\ s a -> s{_gtsrsDescription = a}); --- | The capabilities found within the template. If your template contains IAM resources, you must specify the CAPABILITY_IAM or CAPABILITY_NAMED_IAM value for this parameter when you use the < CreateStack> or < UpdateStack> actions with your template; otherwise, those actions return an InsufficientCapabilities error.------ For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates>.+-- | The capabilities found within the template. If your template contains IAM resources, you must specify the CAPABILITY_IAM or CAPABILITY_NAMED_IAM value for this parameter when you use the 'CreateStack' or 'UpdateStack' actions with your template; otherwise, those actions return an InsufficientCapabilities error. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates> . gtsrsCapabilities :: Lens' GetTemplateSummaryResponse [Capability] gtsrsCapabilities = lens _gtsrsCapabilities (\ s a -> s{_gtsrsCapabilities = a}) . _Default . _Coerce; --- | A list of all the template resource types that are defined in the template, such as 'AWS::EC2::Instance', 'AWS::Dynamo::Table', and 'Custom::MyCustomInstance'.+-- | A list of all the template resource types that are defined in the template, such as @AWS::EC2::Instance@ , @AWS::Dynamo::Table@ , and @Custom::MyCustomInstance@ . gtsrsResourceTypes :: Lens' GetTemplateSummaryResponse [Text] gtsrsResourceTypes = lens _gtsrsResourceTypes (\ s a -> s{_gtsrsResourceTypes = a}) . _Default . _Coerce; --- | The response status code.+-- | -- | The response status code. gtsrsResponseStatus :: Lens' GetTemplateSummaryResponse Int gtsrsResponseStatus = lens _gtsrsResponseStatus (\ s a -> s{_gtsrsResponseStatus = a});
gen/Network/AWS/CloudFormation/ListChangeSets.hs view
@@ -18,7 +18,9 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- Returns the ID and status of each active change set for a stack. For example, AWS CloudFormation lists change sets that are in the 'CREATE_IN_PROGRESS' or 'CREATE_PENDING' state.+-- Returns the ID and status of each active change set for a stack. For example, AWS CloudFormation lists change sets that are in the @CREATE_IN_PROGRESS@ or @CREATE_PENDING@ state.+--+-- module Network.AWS.CloudFormation.ListChangeSets ( -- * Creating a Request@@ -44,8 +46,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for the < ListChangeSets> action.+-- | The input for the 'ListChangeSets' action. --+--+-- -- /See:/ 'listChangeSets' smart constructor. data ListChangeSets = ListChangeSets' { _lcsNextToken :: !(Maybe Text)@@ -56,9 +60,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'lcsNextToken'+-- * 'lcsNextToken' - A string (provided by the 'ListChangeSets' response output) that identifies the next page of change sets that you want to retrieve. ----- * 'lcsStackName'+-- * 'lcsStackName' - The name or the Amazon Resource Name (ARN) of the stack for which you want to list change sets. listChangeSets :: Text -- ^ 'lcsStackName' -> ListChangeSets@@ -68,7 +72,7 @@ , _lcsStackName = pStackName_ } --- | A string (provided by the < ListChangeSets> response output) that identifies the next page of change sets that you want to retrieve.+-- | A string (provided by the 'ListChangeSets' response output) that identifies the next page of change sets that you want to retrieve. lcsNextToken :: Lens' ListChangeSets (Maybe Text) lcsNextToken = lens _lcsNextToken (\ s a -> s{_lcsNextToken = a}); @@ -106,8 +110,10 @@ "NextToken" =: _lcsNextToken, "StackName" =: _lcsStackName] --- | The output for the < ListChangeSets> action.+-- | The output for the 'ListChangeSets' action. --+--+-- -- /See:/ 'listChangeSetsResponse' smart constructor. data ListChangeSetsResponse = ListChangeSetsResponse' { _lcsrsNextToken :: !(Maybe Text)@@ -119,11 +125,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'lcsrsNextToken'+-- * 'lcsrsNextToken' - If the output exceeds 1 MB, a string that identifies the next page of change sets. If there is no additional page, this value is null. ----- * 'lcsrsSummaries'+-- * 'lcsrsSummaries' - A list of @ChangeSetSummary@ structures that provides the ID and status of each change set for the specified stack. ----- * 'lcsrsResponseStatus'+-- * 'lcsrsResponseStatus' - -- | The response status code. listChangeSetsResponse :: Int -- ^ 'lcsrsResponseStatus' -> ListChangeSetsResponse@@ -138,11 +144,11 @@ lcsrsNextToken :: Lens' ListChangeSetsResponse (Maybe Text) lcsrsNextToken = lens _lcsrsNextToken (\ s a -> s{_lcsrsNextToken = a}); --- | A list of 'ChangeSetSummary' structures that provides the ID and status of each change set for the specified stack.+-- | A list of @ChangeSetSummary@ structures that provides the ID and status of each change set for the specified stack. lcsrsSummaries :: Lens' ListChangeSetsResponse [ChangeSetSummary] lcsrsSummaries = lens _lcsrsSummaries (\ s a -> s{_lcsrsSummaries = a}) . _Default . _Coerce; --- | The response status code.+-- | -- | The response status code. lcsrsResponseStatus :: Lens' ListChangeSetsResponse Int lcsrsResponseStatus = lens _lcsrsResponseStatus (\ s a -> s{_lcsrsResponseStatus = a});
+ gen/Network/AWS/CloudFormation/ListExports.hs view
@@ -0,0 +1,138 @@+{-# LANGUAGE DeriveDataTypeable #-}+{-# LANGUAGE DeriveGeneric #-}+{-# LANGUAGE OverloadedStrings #-}+{-# LANGUAGE RecordWildCards #-}+{-# LANGUAGE TypeFamilies #-}++{-# OPTIONS_GHC -fno-warn-unused-imports #-}+{-# OPTIONS_GHC -fno-warn-unused-binds #-}+{-# OPTIONS_GHC -fno-warn-unused-matches #-}++-- Derived from AWS service descriptions, licensed under Apache 2.0.++-- |+-- Module : Network.AWS.CloudFormation.ListExports+-- Copyright : (c) 2013-2016 Brendan Hay+-- License : Mozilla Public License, v. 2.0.+-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>+-- Stability : auto-generated+-- Portability : non-portable (GHC extensions)+--+-- Lists all exported output values in the account and region in which you call this action. Use this action to see the exported output values that you can import into other stacks. To import values, use the <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-importvalue.html @Fn::ImportValue@ > function.+--+--+-- For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-exports.html AWS CloudFormation Export Stack Output Values> .+--+module Network.AWS.CloudFormation.ListExports+ (+ -- * Creating a Request+ listExports+ , ListExports+ -- * Request Lenses+ , leNextToken++ -- * Destructuring the Response+ , listExportsResponse+ , ListExportsResponse+ -- * Response Lenses+ , lersNextToken+ , lersExports+ , lersResponseStatus+ ) where++import Network.AWS.CloudFormation.Types+import Network.AWS.CloudFormation.Types.Product+import Network.AWS.Lens+import Network.AWS.Prelude+import Network.AWS.Request+import Network.AWS.Response++-- | /See:/ 'listExports' smart constructor.+newtype ListExports = ListExports'+ { _leNextToken :: Maybe Text+ } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'ListExports' with the minimum fields required to make a request.+--+-- Use one of the following lenses to modify other fields as desired:+--+-- * 'leNextToken' - A string (provided by the 'ListExports' response output) that identifies the next page of exported output values that you asked to retrieve.+listExports+ :: ListExports+listExports =+ ListExports'+ { _leNextToken = Nothing+ }++-- | A string (provided by the 'ListExports' response output) that identifies the next page of exported output values that you asked to retrieve.+leNextToken :: Lens' ListExports (Maybe Text)+leNextToken = lens _leNextToken (\ s a -> s{_leNextToken = a});++instance AWSRequest ListExports where+ type Rs ListExports = ListExportsResponse+ request = postQuery cloudFormation+ response+ = receiveXMLWrapper "ListExportsResult"+ (\ s h x ->+ ListExportsResponse' <$>+ (x .@? "NextToken") <*>+ (x .@? "Exports" .!@ mempty >>=+ may (parseXMLList "member"))+ <*> (pure (fromEnum s)))++instance Hashable ListExports++instance NFData ListExports++instance ToHeaders ListExports where+ toHeaders = const mempty++instance ToPath ListExports where+ toPath = const "/"++instance ToQuery ListExports where+ toQuery ListExports'{..}+ = mconcat+ ["Action" =: ("ListExports" :: ByteString),+ "Version" =: ("2010-05-15" :: ByteString),+ "NextToken" =: _leNextToken]++-- | /See:/ 'listExportsResponse' smart constructor.+data ListExportsResponse = ListExportsResponse'+ { _lersNextToken :: !(Maybe Text)+ , _lersExports :: !(Maybe [Export])+ , _lersResponseStatus :: !Int+ } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'ListExportsResponse' with the minimum fields required to make a request.+--+-- Use one of the following lenses to modify other fields as desired:+--+-- * 'lersNextToken' - If the output exceeds 100 exported output values, a string that identifies the next page of exports. If there is no additional page, this value is null.+--+-- * 'lersExports' - The output for the 'ListExports' action.+--+-- * 'lersResponseStatus' - -- | The response status code.+listExportsResponse+ :: Int -- ^ 'lersResponseStatus'+ -> ListExportsResponse+listExportsResponse pResponseStatus_ =+ ListExportsResponse'+ { _lersNextToken = Nothing+ , _lersExports = Nothing+ , _lersResponseStatus = pResponseStatus_+ }++-- | If the output exceeds 100 exported output values, a string that identifies the next page of exports. If there is no additional page, this value is null.+lersNextToken :: Lens' ListExportsResponse (Maybe Text)+lersNextToken = lens _lersNextToken (\ s a -> s{_lersNextToken = a});++-- | The output for the 'ListExports' action.+lersExports :: Lens' ListExportsResponse [Export]+lersExports = lens _lersExports (\ s a -> s{_lersExports = a}) . _Default . _Coerce;++-- | -- | The response status code.+lersResponseStatus :: Lens' ListExportsResponse Int+lersResponseStatus = lens _lersResponseStatus (\ s a -> s{_lersResponseStatus = a});++instance NFData ListExportsResponse
+ gen/Network/AWS/CloudFormation/ListImports.hs view
@@ -0,0 +1,149 @@+{-# LANGUAGE DeriveDataTypeable #-}+{-# LANGUAGE DeriveGeneric #-}+{-# LANGUAGE OverloadedStrings #-}+{-# LANGUAGE RecordWildCards #-}+{-# LANGUAGE TypeFamilies #-}++{-# OPTIONS_GHC -fno-warn-unused-imports #-}+{-# OPTIONS_GHC -fno-warn-unused-binds #-}+{-# OPTIONS_GHC -fno-warn-unused-matches #-}++-- Derived from AWS service descriptions, licensed under Apache 2.0.++-- |+-- Module : Network.AWS.CloudFormation.ListImports+-- Copyright : (c) 2013-2016 Brendan Hay+-- License : Mozilla Public License, v. 2.0.+-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>+-- Stability : auto-generated+-- Portability : non-portable (GHC extensions)+--+-- Lists all stacks that are importing an exported output value. To modify or remove an exported output value, first use this action to see which stacks are using it. To see the exported output values in your account, see 'ListExports' .+--+--+-- For more information about importing an exported output value, see the <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-importvalue.html @Fn::ImportValue@ > function.+--+module Network.AWS.CloudFormation.ListImports+ (+ -- * Creating a Request+ listImports+ , ListImports+ -- * Request Lenses+ , liNextToken+ , liExportName++ -- * Destructuring the Response+ , listImportsResponse+ , ListImportsResponse+ -- * Response Lenses+ , lirsImports+ , lirsNextToken+ , lirsResponseStatus+ ) where++import Network.AWS.CloudFormation.Types+import Network.AWS.CloudFormation.Types.Product+import Network.AWS.Lens+import Network.AWS.Prelude+import Network.AWS.Request+import Network.AWS.Response++-- | /See:/ 'listImports' smart constructor.+data ListImports = ListImports'+ { _liNextToken :: !(Maybe Text)+ , _liExportName :: !Text+ } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'ListImports' with the minimum fields required to make a request.+--+-- Use one of the following lenses to modify other fields as desired:+--+-- * 'liNextToken' - A string (provided by the 'ListImports' response output) that identifies the next page of stacks that are importing the specified exported output value.+--+-- * 'liExportName' - The name of the exported output value. AWS CloudFormation returns the stack names that are importing this value.+listImports+ :: Text -- ^ 'liExportName'+ -> ListImports+listImports pExportName_ =+ ListImports'+ { _liNextToken = Nothing+ , _liExportName = pExportName_+ }++-- | A string (provided by the 'ListImports' response output) that identifies the next page of stacks that are importing the specified exported output value.+liNextToken :: Lens' ListImports (Maybe Text)+liNextToken = lens _liNextToken (\ s a -> s{_liNextToken = a});++-- | The name of the exported output value. AWS CloudFormation returns the stack names that are importing this value.+liExportName :: Lens' ListImports Text+liExportName = lens _liExportName (\ s a -> s{_liExportName = a});++instance AWSRequest ListImports where+ type Rs ListImports = ListImportsResponse+ request = postQuery cloudFormation+ response+ = receiveXMLWrapper "ListImportsResult"+ (\ s h x ->+ ListImportsResponse' <$>+ (x .@? "Imports" .!@ mempty >>=+ may (parseXMLList "member"))+ <*> (x .@? "NextToken")+ <*> (pure (fromEnum s)))++instance Hashable ListImports++instance NFData ListImports++instance ToHeaders ListImports where+ toHeaders = const mempty++instance ToPath ListImports where+ toPath = const "/"++instance ToQuery ListImports where+ toQuery ListImports'{..}+ = mconcat+ ["Action" =: ("ListImports" :: ByteString),+ "Version" =: ("2010-05-15" :: ByteString),+ "NextToken" =: _liNextToken,+ "ExportName" =: _liExportName]++-- | /See:/ 'listImportsResponse' smart constructor.+data ListImportsResponse = ListImportsResponse'+ { _lirsImports :: !(Maybe [Text])+ , _lirsNextToken :: !(Maybe Text)+ , _lirsResponseStatus :: !Int+ } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'ListImportsResponse' with the minimum fields required to make a request.+--+-- Use one of the following lenses to modify other fields as desired:+--+-- * 'lirsImports' - A list of stack names that are importing the specified exported output value.+--+-- * 'lirsNextToken' - A string that identifies the next page of exports. If there is no additional page, this value is null.+--+-- * 'lirsResponseStatus' - -- | The response status code.+listImportsResponse+ :: Int -- ^ 'lirsResponseStatus'+ -> ListImportsResponse+listImportsResponse pResponseStatus_ =+ ListImportsResponse'+ { _lirsImports = Nothing+ , _lirsNextToken = Nothing+ , _lirsResponseStatus = pResponseStatus_+ }++-- | A list of stack names that are importing the specified exported output value.+lirsImports :: Lens' ListImportsResponse [Text]+lirsImports = lens _lirsImports (\ s a -> s{_lirsImports = a}) . _Default . _Coerce;++-- | A string that identifies the next page of exports. If there is no additional page, this value is null.+lirsNextToken :: Lens' ListImportsResponse (Maybe Text)+lirsNextToken = lens _lirsNextToken (\ s a -> s{_lirsNextToken = a});++-- | -- | The response status code.+lirsResponseStatus :: Lens' ListImportsResponse Int+lirsResponseStatus = lens _lirsResponseStatus (\ s a -> s{_lirsResponseStatus = a});++instance NFData ListImportsResponse
gen/Network/AWS/CloudFormation/ListStackResources.hs view
@@ -20,8 +20,10 @@ -- -- Returns descriptions of all resources of the specified stack. --+-- -- For deleted stacks, ListStackResources returns resource information for up to 90 days after the stack has been deleted. --+-- -- This operation returns paginated results. module Network.AWS.CloudFormation.ListStackResources (@@ -49,8 +51,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for the < ListStackResource> action.+-- | The input for the 'ListStackResource' action. --+--+-- -- /See:/ 'listStackResources' smart constructor. data ListStackResources = ListStackResources' { _lsrNextToken :: !(Maybe Text)@@ -61,9 +65,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'lsrNextToken'+-- * 'lsrNextToken' - A string that identifies the next page of stack resources that you want to retrieve. ----- * 'lsrStackName'+-- * 'lsrStackName' - The name or the unique stack ID that is associated with the stack, which are not always interchangeable: * Running stacks: You can specify either the stack's name or its unique stack ID. * Deleted stacks: You must specify the unique stack ID. Default: There is no default value. listStackResources :: Text -- ^ 'lsrStackName' -> ListStackResources@@ -77,13 +81,7 @@ lsrNextToken :: Lens' ListStackResources (Maybe Text) lsrNextToken = lens _lsrNextToken (\ s a -> s{_lsrNextToken = a}); --- | The name or the unique stack ID that is associated with the stack, which are not always interchangeable:------ - Running stacks: You can specify either the stack\'s name or its unique stack ID.------ - Deleted stacks: You must specify the unique stack ID.------ Default: There is no default value.+-- | The name or the unique stack ID that is associated with the stack, which are not always interchangeable: * Running stacks: You can specify either the stack's name or its unique stack ID. * Deleted stacks: You must specify the unique stack ID. Default: There is no default value. lsrStackName :: Lens' ListStackResources Text lsrStackName = lens _lsrStackName (\ s a -> s{_lsrStackName = a}); @@ -125,8 +123,10 @@ "NextToken" =: _lsrNextToken, "StackName" =: _lsrStackName] --- | The output for a < ListStackResources> action.+-- | The output for a 'ListStackResources' action. --+--+-- -- /See:/ 'listStackResourcesResponse' smart constructor. data ListStackResourcesResponse = ListStackResourcesResponse' { _lsrrsNextToken :: !(Maybe Text)@@ -138,11 +138,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'lsrrsNextToken'+-- * 'lsrrsNextToken' - If the output exceeds 1 MB, a string that identifies the next page of stack resources. If no additional page exists, this value is null. ----- * 'lsrrsStackResourceSummaries'+-- * 'lsrrsStackResourceSummaries' - A list of @StackResourceSummary@ structures. ----- * 'lsrrsResponseStatus'+-- * 'lsrrsResponseStatus' - -- | The response status code. listStackResourcesResponse :: Int -- ^ 'lsrrsResponseStatus' -> ListStackResourcesResponse@@ -157,11 +157,11 @@ lsrrsNextToken :: Lens' ListStackResourcesResponse (Maybe Text) lsrrsNextToken = lens _lsrrsNextToken (\ s a -> s{_lsrrsNextToken = a}); --- | A list of 'StackResourceSummary' structures.+-- | A list of @StackResourceSummary@ structures. lsrrsStackResourceSummaries :: Lens' ListStackResourcesResponse [StackResourceSummary] lsrrsStackResourceSummaries = lens _lsrrsStackResourceSummaries (\ s a -> s{_lsrrsStackResourceSummaries = a}) . _Default . _Coerce; --- | The response status code.+-- | -- | The response status code. lsrrsResponseStatus :: Lens' ListStackResourcesResponse Int lsrrsResponseStatus = lens _lsrrsResponseStatus (\ s a -> s{_lsrrsResponseStatus = a});
gen/Network/AWS/CloudFormation/ListStacks.hs view
@@ -20,6 +20,8 @@ -- -- Returns the summary information for stacks whose status matches the specified StackStatusFilter. Summary information for stacks that have been deleted is kept for 90 days after the stack is deleted. If no StackStatusFilter is specified, summary information for all stacks is returned (including existing stacks and stacks that have been deleted). --+--+-- -- This operation returns paginated results. module Network.AWS.CloudFormation.ListStacks (@@ -47,8 +49,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for < ListStacks> action.+-- | The input for 'ListStacks' action. --+--+-- -- /See:/ 'listStacks' smart constructor. data ListStacks = ListStacks' { _lsNextToken :: !(Maybe Text)@@ -59,9 +63,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'lsNextToken'+-- * 'lsNextToken' - A string that identifies the next page of stacks that you want to retrieve. ----- * 'lsStackStatusFilter'+-- * 'lsStackStatusFilter' - Stack status to use as a filter. Specify one or more stack status codes to list only stacks with the specified status codes. For a complete list of stack status codes, see the @StackStatus@ parameter of the 'Stack' data type. listStacks :: ListStacks listStacks =@@ -74,7 +78,7 @@ lsNextToken :: Lens' ListStacks (Maybe Text) lsNextToken = lens _lsNextToken (\ s a -> s{_lsNextToken = a}); --- | Stack status to use as a filter. Specify one or more stack status codes to list only stacks with the specified status codes. For a complete list of stack status codes, see the 'StackStatus' parameter of the < Stack> data type.+-- | Stack status to use as a filter. Specify one or more stack status codes to list only stacks with the specified status codes. For a complete list of stack status codes, see the @StackStatus@ parameter of the 'Stack' data type. lsStackStatusFilter :: Lens' ListStacks [StackStatus] lsStackStatusFilter = lens _lsStackStatusFilter (\ s a -> s{_lsStackStatusFilter = a}) . _Default . _Coerce; @@ -117,8 +121,10 @@ toQuery (toQueryList "member" <$> _lsStackStatusFilter)] --- | The output for < ListStacks> action.+-- | The output for 'ListStacks' action. --+--+-- -- /See:/ 'listStacksResponse' smart constructor. data ListStacksResponse = ListStacksResponse' { _lsrsNextToken :: !(Maybe Text)@@ -130,11 +136,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'lsrsNextToken'+-- * 'lsrsNextToken' - If the output exceeds 1 MB in size, a string that identifies the next page of stacks. If no additional page exists, this value is null. ----- * 'lsrsStackSummaries'+-- * 'lsrsStackSummaries' - A list of @StackSummary@ structures containing information about the specified stacks. ----- * 'lsrsResponseStatus'+-- * 'lsrsResponseStatus' - -- | The response status code. listStacksResponse :: Int -- ^ 'lsrsResponseStatus' -> ListStacksResponse@@ -149,11 +155,11 @@ lsrsNextToken :: Lens' ListStacksResponse (Maybe Text) lsrsNextToken = lens _lsrsNextToken (\ s a -> s{_lsrsNextToken = a}); --- | A list of 'StackSummary' structures containing information about the specified stacks.+-- | A list of @StackSummary@ structures containing information about the specified stacks. lsrsStackSummaries :: Lens' ListStacksResponse [StackSummary] lsrsStackSummaries = lens _lsrsStackSummaries (\ s a -> s{_lsrsStackSummaries = a}) . _Default . _Coerce; --- | The response status code.+-- | -- | The response status code. lsrsResponseStatus :: Lens' ListStacksResponse Int lsrsResponseStatus = lens _lsrsResponseStatus (\ s a -> s{_lsrsResponseStatus = a});
gen/Network/AWS/CloudFormation/SetStackPolicy.hs view
@@ -19,6 +19,8 @@ -- Portability : non-portable (GHC extensions) -- -- Sets a stack policy for a specified stack.+--+-- module Network.AWS.CloudFormation.SetStackPolicy ( -- * Creating a Request@@ -41,8 +43,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for the < SetStackPolicy> action.+-- | The input for the 'SetStackPolicy' action. --+--+-- -- /See:/ 'setStackPolicy' smart constructor. data SetStackPolicy = SetStackPolicy' { _sspStackPolicyBody :: !(Maybe Text)@@ -54,11 +58,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'sspStackPolicyBody'+-- * 'sspStackPolicyBody' - Structure containing the stack policy body. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/protect-stack-resources.html Prevent Updates to Stack Resources> in the AWS CloudFormation User Guide. You can specify either the @StackPolicyBody@ or the @StackPolicyURL@ parameter, but not both. ----- * 'sspStackPolicyURL'+-- * 'sspStackPolicyURL' - Location of a file containing the stack policy. The URL must point to a policy (maximum size: 16 KB) located in an S3 bucket in the same region as the stack. You can specify either the @StackPolicyBody@ or the @StackPolicyURL@ parameter, but not both. ----- * 'sspStackName'+-- * 'sspStackName' - The name or unique stack ID that you want to associate a policy with. setStackPolicy :: Text -- ^ 'sspStackName' -> SetStackPolicy@@ -69,11 +73,11 @@ , _sspStackName = pStackName_ } --- | Structure containing the stack policy body. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/protect-stack-resources.html Prevent Updates to Stack Resources> in the AWS CloudFormation User Guide. You can specify either the 'StackPolicyBody' or the 'StackPolicyURL' parameter, but not both.+-- | Structure containing the stack policy body. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/protect-stack-resources.html Prevent Updates to Stack Resources> in the AWS CloudFormation User Guide. You can specify either the @StackPolicyBody@ or the @StackPolicyURL@ parameter, but not both. sspStackPolicyBody :: Lens' SetStackPolicy (Maybe Text) sspStackPolicyBody = lens _sspStackPolicyBody (\ s a -> s{_sspStackPolicyBody = a}); --- | Location of a file containing the stack policy. The URL must point to a policy (maximum size: 16 KB) located in an S3 bucket in the same region as the stack. You can specify either the 'StackPolicyBody' or the 'StackPolicyURL' parameter, but not both.+-- | Location of a file containing the stack policy. The URL must point to a policy (maximum size: 16 KB) located in an S3 bucket in the same region as the stack. You can specify either the @StackPolicyBody@ or the @StackPolicyURL@ parameter, but not both. sspStackPolicyURL :: Lens' SetStackPolicy (Maybe Text) sspStackPolicyURL = lens _sspStackPolicyURL (\ s a -> s{_sspStackPolicyURL = a});
gen/Network/AWS/CloudFormation/SignalResource.hs view
@@ -18,7 +18,9 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- Sends a signal to the specified resource with a success or failure status. You can use the SignalResource API in conjunction with a creation policy or update policy. AWS CloudFormation doesn\'t proceed with a stack creation or update until resources receive the required number of signals or the timeout period is exceeded. The SignalResource API is useful in cases where you want to send signals from anywhere other than an Amazon EC2 instance.+-- Sends a signal to the specified resource with a success or failure status. You can use the SignalResource API in conjunction with a creation policy or update policy. AWS CloudFormation doesn't proceed with a stack creation or update until resources receive the required number of signals or the timeout period is exceeded. The SignalResource API is useful in cases where you want to send signals from anywhere other than an Amazon EC2 instance.+--+-- module Network.AWS.CloudFormation.SignalResource ( -- * Creating a Request@@ -42,8 +44,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for the < SignalResource> action.+-- | The input for the 'SignalResource' action. --+--+-- -- /See:/ 'signalResource' smart constructor. data SignalResource = SignalResource' { _sigStackName :: !Text@@ -56,13 +60,13 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'sigStackName'+-- * 'sigStackName' - The stack name or unique stack ID that includes the resource that you want to signal. ----- * 'sigLogicalResourceId'+-- * 'sigLogicalResourceId' - The logical ID of the resource that you want to signal. The logical ID is the name of the resource that given in the template. ----- * 'sigUniqueId'+-- * 'sigUniqueId' - A unique ID of the signal. When you signal Amazon EC2 instances or Auto Scaling groups, specify the instance ID that you are signaling as the unique ID. If you send multiple signals to a single resource (such as signaling a wait condition), each signal requires a different unique ID. ----- * 'sigStatus'+-- * 'sigStatus' - The status of the signal, which is either success or failure. A failure signal causes AWS CloudFormation to immediately fail the stack creation or update. signalResource :: Text -- ^ 'sigStackName' -> Text -- ^ 'sigLogicalResourceId'
gen/Network/AWS/CloudFormation/Types.hs view
@@ -31,6 +31,9 @@ -- * ChangeSetStatus , ChangeSetStatus (..) + -- * ChangeSetType+ , ChangeSetType (..)+ -- * ChangeSource , ChangeSource (..) @@ -64,6 +67,9 @@ -- * StackStatus , StackStatus (..) + -- * TemplateStage+ , TemplateStage (..)+ -- * AccountLimit , AccountLimit , accountLimit@@ -89,6 +95,13 @@ , cssDescription , cssStackName + -- * Export+ , Export+ , export'+ , eValue+ , eExportingStackId+ , eName+ -- * Output , Output , output@@ -151,6 +164,7 @@ , sLastUpdatedTime , sNotificationARNs , sStackStatusReason+ , sChangeSetId , sOutputs , sParameters , sStackId@@ -158,6 +172,7 @@ , sCapabilities , sTags , sTimeoutInMinutes+ , sRoleARN , sStackName , sCreationTime , sStackStatus@@ -246,7 +261,7 @@ import Network.AWS.Prelude import Network.AWS.Sign.V4 --- | API version '2010-05-15' of the Amazon CloudFormation SDK configuration.+-- | API version @2010-05-15@ of the Amazon CloudFormation SDK configuration. cloudFormation :: Service cloudFormation = Service@@ -280,27 +295,37 @@ | has (hasStatus 509) e = Just "limit_exceeded" | otherwise = Nothing --- | The specified change set name or ID doesn\'t exit. To view valid change sets for a stack, use the 'ListChangeSets' action.+-- | The specified change set name or ID doesn't exit. To view valid change sets for a stack, use the @ListChangeSets@ action.+--+-- _ChangeSetNotFoundException :: AsError a => Getting (First ServiceError) a ServiceError _ChangeSetNotFoundException = _ServiceError . hasStatus 404 . hasCode "ChangeSetNotFound" --- | The specified change set cannot be used to update the stack. For example, the change set status might be 'CREATE_IN_PROGRESS' or the stack status might be 'UPDATE_IN_PROGRESS'.+-- | The specified change set cannot be used to update the stack. For example, the change set status might be @CREATE_IN_PROGRESS@ or the stack status might be @UPDATE_IN_PROGRESS@ .+--+-- _InvalidChangeSetStatusException :: AsError a => Getting (First ServiceError) a ServiceError _InvalidChangeSetStatusException = _ServiceError . hasStatus 400 . hasCode "InvalidChangeSetStatus" -- | The template contains resources with capabilities that were not specified in the Capabilities parameter.+--+-- _InsufficientCapabilitiesException :: AsError a => Getting (First ServiceError) a ServiceError _InsufficientCapabilitiesException = _ServiceError . hasStatus 400 . hasCode "InsufficientCapabilitiesException" -- | Resource with the name requested already exists.+--+-- _AlreadyExistsException :: AsError a => Getting (First ServiceError) a ServiceError _AlreadyExistsException = _ServiceError . hasStatus 400 . hasCode "AlreadyExistsException" -- | Quota for the resource has already been reached.+--+-- _LimitExceededException :: AsError a => Getting (First ServiceError) a ServiceError _LimitExceededException = _ServiceError . hasStatus 400 . hasCode "LimitExceededException"
gen/Network/AWS/CloudFormation/Types/Product.hs view
@@ -23,6 +23,8 @@ -- | The AccountLimit data type. --+--+-- -- /See:/ 'accountLimit' smart constructor. data AccountLimit = AccountLimit' { _alValue :: !(Maybe Int)@@ -33,9 +35,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'alValue'+-- * 'alValue' - The value that is associated with the account limit name. ----- * 'alName'+-- * 'alName' - The name of the account limit. Currently, the only account limit is @StackLimit@ . accountLimit :: AccountLimit accountLimit =@@ -48,7 +50,7 @@ alValue :: Lens' AccountLimit (Maybe Int) alValue = lens _alValue (\ s a -> s{_alValue = a}); --- | The name of the account limit. Currently, the only account limit is 'StackLimit'.+-- | The name of the account limit. Currently, the only account limit is @StackLimit@ . alName :: Lens' AccountLimit (Maybe Text) alName = lens _alName (\ s a -> s{_alName = a}); @@ -61,8 +63,10 @@ instance NFData AccountLimit --- | The 'Change' structure describes the changes AWS CloudFormation will perform if you execute the change set.+-- | The @Change@ structure describes the changes AWS CloudFormation will perform if you execute the change set. --+--+-- -- /See:/ 'change' smart constructor. data Change = Change' { _cResourceChange :: !(Maybe ResourceChange)@@ -73,9 +77,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'cResourceChange'+-- * 'cResourceChange' - A @ResourceChange@ structure that describes the resource and action that AWS CloudFormation will perform. ----- * 'cType'+-- * 'cType' - The type of entity that AWS CloudFormation changes. Currently, the only entity type is @Resource@ . change :: Change change =@@ -84,11 +88,11 @@ , _cType = Nothing } --- | A 'ResourceChange' structure that describes the resource and action that AWS CloudFormation will perform.+-- | A @ResourceChange@ structure that describes the resource and action that AWS CloudFormation will perform. cResourceChange :: Lens' Change (Maybe ResourceChange) cResourceChange = lens _cResourceChange (\ s a -> s{_cResourceChange = a}); --- | The type of entity that AWS CloudFormation changes. Currently, the only entity type is 'Resource'.+-- | The type of entity that AWS CloudFormation changes. Currently, the only entity type is @Resource@ . cType :: Lens' Change (Maybe ChangeType) cType = lens _cType (\ s a -> s{_cType = a}); @@ -101,8 +105,10 @@ instance NFData Change --- | The 'ChangeSetSummary' structure describes a change set, its status, and the stack with which it\'s associated.+-- | The @ChangeSetSummary@ structure describes a change set, its status, and the stack with which it's associated. --+--+-- -- /See:/ 'changeSetSummary' smart constructor. data ChangeSetSummary = ChangeSetSummary' { _cssCreationTime :: !(Maybe ISO8601)@@ -120,23 +126,23 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'cssCreationTime'+-- * 'cssCreationTime' - The start time when the change set was created, in UTC. ----- * 'cssStatus'+-- * 'cssStatus' - The state of the change set, such as @CREATE_IN_PROGRESS@ , @CREATE_COMPLETE@ , or @FAILED@ . ----- * 'cssChangeSetName'+-- * 'cssChangeSetName' - The name of the change set. ----- * 'cssExecutionStatus'+-- * 'cssExecutionStatus' - 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. ----- * 'cssChangeSetId'+-- * 'cssChangeSetId' - The ID of the change set. ----- * 'cssStatusReason'+-- * 'cssStatusReason' - A description of the change set's status. For example, if your change set is in the @FAILED@ state, AWS CloudFormation shows the error message. ----- * 'cssStackId'+-- * 'cssStackId' - The ID of the stack with which the change set is associated. ----- * 'cssDescription'+-- * 'cssDescription' - Descriptive information about the change set. ----- * 'cssStackName'+-- * 'cssStackName' - The name of the stack with which the change set is associated. changeSetSummary :: ChangeSetSummary changeSetSummary =@@ -156,7 +162,7 @@ cssCreationTime :: Lens' ChangeSetSummary (Maybe UTCTime) cssCreationTime = lens _cssCreationTime (\ s a -> s{_cssCreationTime = a}) . mapping _Time; --- | The state of the change set, such as 'CREATE_IN_PROGRESS', 'CREATE_COMPLETE', or 'FAILED'.+-- | The state of the change set, such as @CREATE_IN_PROGRESS@ , @CREATE_COMPLETE@ , or @FAILED@ . cssStatus :: Lens' ChangeSetSummary (Maybe ChangeSetStatus) cssStatus = lens _cssStatus (\ s a -> s{_cssStatus = a}); @@ -164,7 +170,7 @@ cssChangeSetName :: Lens' ChangeSetSummary (Maybe Text) cssChangeSetName = lens _cssChangeSetName (\ s a -> s{_cssChangeSetName = a}); --- | 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.+-- | 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. cssExecutionStatus :: Lens' ChangeSetSummary (Maybe ExecutionStatus) cssExecutionStatus = lens _cssExecutionStatus (\ s a -> s{_cssExecutionStatus = a}); @@ -172,7 +178,7 @@ cssChangeSetId :: Lens' ChangeSetSummary (Maybe Text) cssChangeSetId = lens _cssChangeSetId (\ s a -> s{_cssChangeSetId = a}); --- | A description of the change set\'s status. For example, if your change set is in the 'FAILED' state, AWS CloudFormation shows the error message.+-- | A description of the change set's status. For example, if your change set is in the @FAILED@ state, AWS CloudFormation shows the error message. cssStatusReason :: Lens' ChangeSetSummary (Maybe Text) cssStatusReason = lens _cssStatusReason (\ s a -> s{_cssStatusReason = a}); @@ -204,8 +210,61 @@ instance NFData ChangeSetSummary +-- | The @Export@ structure describes the exported output values for a stack.+--+--+--+-- /See:/ 'export'' smart constructor.+data Export = Export'+ { _eValue :: !(Maybe Text)+ , _eExportingStackId :: !(Maybe Text)+ , _eName :: !(Maybe Text)+ } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'Export' with the minimum fields required to make a request.+--+-- Use one of the following lenses to modify other fields as desired:+--+-- * 'eValue' - The value of the exported output, such as a resource physical ID. This value is defined in the @Export@ field in the associated stack's @Outputs@ section.+--+-- * 'eExportingStackId' - The stack that contains the exported output name and value.+--+-- * 'eName' - The name of exported output value. Use this name and the @Fn::ImportValue@ function to import the associated value into other stacks. The name is defined in the @Export@ field in the associated stack's @Outputs@ section.+export'+ :: Export+export' =+ Export'+ { _eValue = Nothing+ , _eExportingStackId = Nothing+ , _eName = Nothing+ }++-- | The value of the exported output, such as a resource physical ID. This value is defined in the @Export@ field in the associated stack's @Outputs@ section.+eValue :: Lens' Export (Maybe Text)+eValue = lens _eValue (\ s a -> s{_eValue = a});++-- | The stack that contains the exported output name and value.+eExportingStackId :: Lens' Export (Maybe Text)+eExportingStackId = lens _eExportingStackId (\ s a -> s{_eExportingStackId = a});++-- | The name of exported output value. Use this name and the @Fn::ImportValue@ function to import the associated value into other stacks. The name is defined in the @Export@ field in the associated stack's @Outputs@ section.+eName :: Lens' Export (Maybe Text)+eName = lens _eName (\ s a -> s{_eName = a});++instance FromXML Export where+ parseXML x+ = Export' <$>+ (x .@? "Value") <*> (x .@? "ExportingStackId") <*>+ (x .@? "Name")++instance Hashable Export++instance NFData Export+ -- | The Output data type. --+--+-- -- /See:/ 'output' smart constructor. data Output = Output' { _oOutputValue :: !(Maybe Text)@@ -217,11 +276,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'oOutputValue'+-- * 'oOutputValue' - The value associated with the output. ----- * 'oOutputKey'+-- * 'oOutputKey' - The key associated with the output. ----- * 'oDescription'+-- * 'oDescription' - User defined description associated with the output. output :: Output output =@@ -255,6 +314,8 @@ -- | The Parameter data type. --+--+-- -- /See:/ 'parameter' smart constructor. data Parameter = Parameter' { _pParameterValue :: !(Maybe Text)@@ -266,11 +327,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'pParameterValue'+-- * 'pParameterValue' - The value associated with the parameter. ----- * 'pParameterKey'+-- * 'pParameterKey' - The key associated with the parameter. If you don't specify a key and value for a particular parameter, AWS CloudFormation uses the default value that is specified in your template. ----- * 'pUsePreviousValue'+-- * 'pUsePreviousValue' - During a stack update, use the existing parameter value that the stack is using for a given parameter key. If you specify @true@ , do not specify a parameter value. parameter :: Parameter parameter =@@ -284,11 +345,11 @@ pParameterValue :: Lens' Parameter (Maybe Text) pParameterValue = lens _pParameterValue (\ s a -> s{_pParameterValue = a}); --- | The key associated with the parameter. If you don\'t specify a key and value for a particular parameter, AWS CloudFormation uses the default value that is specified in your template.+-- | The key associated with the parameter. If you don't specify a key and value for a particular parameter, AWS CloudFormation uses the default value that is specified in your template. pParameterKey :: Lens' Parameter (Maybe Text) pParameterKey = lens _pParameterKey (\ s a -> s{_pParameterKey = a}); --- | During a stack update, use the existing parameter value that the stack is using for a given parameter key. If you specify 'true', do not specify a parameter value.+-- | During a stack update, use the existing parameter value that the stack is using for a given parameter key. If you specify @true@ , do not specify a parameter value. pUsePreviousValue :: Lens' Parameter (Maybe Bool) pUsePreviousValue = lens _pUsePreviousValue (\ s a -> s{_pUsePreviousValue = a}); @@ -309,8 +370,10 @@ "ParameterKey" =: _pParameterKey, "UsePreviousValue" =: _pUsePreviousValue] --- | A set of criteria that AWS CloudFormation uses to validate parameter values. Although other constraints might be defined in the stack template, AWS CloudFormation returns only the 'AllowedValues' property.+-- | A set of criteria that AWS CloudFormation uses to validate parameter values. Although other constraints might be defined in the stack template, AWS CloudFormation returns only the @AllowedValues@ property. --+--+-- -- /See:/ 'parameterConstraints' smart constructor. newtype ParameterConstraints = ParameterConstraints' { _pcAllowedValues :: Maybe [Text]@@ -320,7 +383,7 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'pcAllowedValues'+-- * 'pcAllowedValues' - A list of values that are permitted for a parameter. parameterConstraints :: ParameterConstraints parameterConstraints =@@ -344,6 +407,8 @@ -- | The ParameterDeclaration data type. --+--+-- -- /See:/ 'parameterDeclaration' smart constructor. data ParameterDeclaration = ParameterDeclaration' { _pdParameterKey :: !(Maybe Text)@@ -358,17 +423,17 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'pdParameterKey'+-- * 'pdParameterKey' - The name that is associated with the parameter. ----- * 'pdParameterType'+-- * 'pdParameterType' - The type of parameter. ----- * 'pdParameterConstraints'+-- * 'pdParameterConstraints' - The criteria that AWS CloudFormation uses to validate parameter values. ----- * 'pdDefaultValue'+-- * 'pdDefaultValue' - The default value of the parameter. ----- * 'pdNoEcho'+-- * 'pdNoEcho' - Flag that indicates whether the parameter value is shown as plain text in logs and in the AWS Management Console. ----- * 'pdDescription'+-- * 'pdDescription' - The description that is associate with the parameter. parameterDeclaration :: ParameterDeclaration parameterDeclaration =@@ -418,8 +483,10 @@ instance NFData ParameterDeclaration --- | The 'ResourceChange' structure describes the resource and the action that AWS CloudFormation will perform on it if you execute this change set.+-- | The @ResourceChange@ structure describes the resource and the action that AWS CloudFormation will perform on it if you execute this change set. --+--+-- -- /See:/ 'resourceChange' smart constructor. data ResourceChange = ResourceChange' { _rcLogicalResourceId :: !(Maybe Text)@@ -435,19 +502,19 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'rcLogicalResourceId'+-- * 'rcLogicalResourceId' - The resource's logical ID, which is defined in the stack's template. ----- * 'rcPhysicalResourceId'+-- * 'rcPhysicalResourceId' - The resource's physical ID (resource name). Resources that you are adding don't have physical IDs because they haven't been created. ----- * 'rcResourceType'+-- * 'rcResourceType' - The type of AWS CloudFormation resource, such as @AWS::S3::Bucket@ . ----- * 'rcAction'+-- * 'rcAction' - The action that AWS CloudFormation takes on the resource, such as @Add@ (adds a new resource), @Modify@ (changes a resource), or @Remove@ (deletes a resource). ----- * 'rcScope'+-- * 'rcScope' - For the @Modify@ action, indicates which resource attribute is triggering this update, such as a change in the resource attribute's @Metadata@ , @Properties@ , or @Tags@ . ----- * 'rcDetails'+-- * 'rcDetails' - For the @Modify@ action, a list of @ResourceChangeDetail@ structures that describes the changes that AWS CloudFormation will make to the resource. ----- * 'rcReplacement'+-- * 'rcReplacement' - For the @Modify@ action, indicates whether AWS CloudFormation will replace the resource by creating a new one and deleting the old one. This value depends on the value of the @RequiresRecreation@ property in the @ResourceTargetDefinition@ structure. For example, if the @RequiresRecreation@ field is @Always@ and the @Evaluation@ field is @Static@ , @Replacement@ is @True@ . If the @RequiresRecreation@ field is @Always@ and the @Evaluation@ field is @Dynamic@ , @Replacement@ is @Conditionally@ . If you have multiple changes with different @RequiresRecreation@ values, the @Replacement@ value depends on the change with the most impact. A @RequiresRecreation@ value of @Always@ has the most impact, followed by @Conditionally@ , and then @Never@ . resourceChange :: ResourceChange resourceChange =@@ -461,33 +528,31 @@ , _rcReplacement = Nothing } --- | The resource\'s logical ID, which is defined in the stack\'s template.+-- | The resource's logical ID, which is defined in the stack's template. rcLogicalResourceId :: Lens' ResourceChange (Maybe Text) rcLogicalResourceId = lens _rcLogicalResourceId (\ s a -> s{_rcLogicalResourceId = a}); --- | The resource\'s physical ID (resource name). Resources that you are adding don\'t have physical IDs because they haven\'t been created.+-- | The resource's physical ID (resource name). Resources that you are adding don't have physical IDs because they haven't been created. rcPhysicalResourceId :: Lens' ResourceChange (Maybe Text) rcPhysicalResourceId = lens _rcPhysicalResourceId (\ s a -> s{_rcPhysicalResourceId = a}); --- | The type of AWS CloudFormation resource, such as 'AWS::S3::Bucket'.+-- | The type of AWS CloudFormation resource, such as @AWS::S3::Bucket@ . rcResourceType :: Lens' ResourceChange (Maybe Text) rcResourceType = lens _rcResourceType (\ s a -> s{_rcResourceType = a}); --- | The action that AWS CloudFormation takes on the resource, such as 'Add' (adds a new resource), 'Modify' (changes a resource), or 'Remove' (deletes a resource).+-- | The action that AWS CloudFormation takes on the resource, such as @Add@ (adds a new resource), @Modify@ (changes a resource), or @Remove@ (deletes a resource). rcAction :: Lens' ResourceChange (Maybe ChangeAction) rcAction = lens _rcAction (\ s a -> s{_rcAction = a}); --- | For the 'Modify' action, indicates which resource attribute is triggering this update, such as a change in the resource attribute\'s 'Metadata', 'Properties', or 'Tags'.+-- | For the @Modify@ action, indicates which resource attribute is triggering this update, such as a change in the resource attribute's @Metadata@ , @Properties@ , or @Tags@ . rcScope :: Lens' ResourceChange [ResourceAttribute] rcScope = lens _rcScope (\ s a -> s{_rcScope = a}) . _Default . _Coerce; --- | For the 'Modify' action, a list of 'ResourceChangeDetail' structures that describes the changes that AWS CloudFormation will make to the resource.+-- | For the @Modify@ action, a list of @ResourceChangeDetail@ structures that describes the changes that AWS CloudFormation will make to the resource. rcDetails :: Lens' ResourceChange [ResourceChangeDetail] rcDetails = lens _rcDetails (\ s a -> s{_rcDetails = a}) . _Default . _Coerce; --- | For the 'Modify' action, indicates whether AWS CloudFormation will replace the resource by creating a new one and deleting the old one. This value depends on the value of the 'RequiresRecreation' property in the 'ResourceTargetDefinition' structure. For example, if the 'RequiresRecreation' field is 'Always' and the 'Evaluation' field is 'Static', 'Replacement' is 'True'. If the 'RequiresRecreation' field is 'Always' and the 'Evaluation' field is 'Dynamic', 'Replacement' is 'Conditionally'.------ If you have multiple changes with different 'RequiresRecreation' values, the 'Replacement' value depends on the change with the most impact. A 'RequiresRecreation' value of 'Always' has the most impact, followed by 'Conditionally', and then 'Never'.+-- | For the @Modify@ action, indicates whether AWS CloudFormation will replace the resource by creating a new one and deleting the old one. This value depends on the value of the @RequiresRecreation@ property in the @ResourceTargetDefinition@ structure. For example, if the @RequiresRecreation@ field is @Always@ and the @Evaluation@ field is @Static@ , @Replacement@ is @True@ . If the @RequiresRecreation@ field is @Always@ and the @Evaluation@ field is @Dynamic@ , @Replacement@ is @Conditionally@ . If you have multiple changes with different @RequiresRecreation@ values, the @Replacement@ value depends on the change with the most impact. A @RequiresRecreation@ value of @Always@ has the most impact, followed by @Conditionally@ , and then @Never@ . rcReplacement :: Lens' ResourceChange (Maybe Replacement) rcReplacement = lens _rcReplacement (\ s a -> s{_rcReplacement = a}); @@ -510,8 +575,10 @@ instance NFData ResourceChange --- | For a resource with 'Modify' as the action, the 'ResourceChange' structure describes the changes AWS CloudFormation will make to that resource.+-- | For a resource with @Modify@ as the action, the @ResourceChange@ structure describes the changes AWS CloudFormation will make to that resource. --+--+-- -- /See:/ 'resourceChangeDetail' smart constructor. data ResourceChangeDetail = ResourceChangeDetail' { _rcdCausingEntity :: !(Maybe Text)@@ -524,13 +591,13 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'rcdCausingEntity'+-- * 'rcdCausingEntity' - The identity of the entity that triggered this change. This entity is a member of the group that is specified by the @ChangeSource@ field. For example, if you modified the value of the @KeyPairName@ parameter, the @CausingEntity@ is the name of the parameter (@KeyPairName@ ). If the @ChangeSource@ value is @DirectModification@ , no value is given for @CausingEntity@ . ----- * 'rcdChangeSource'+-- * 'rcdChangeSource' - The group to which the @CausingEntity@ value belongs. There are five entity groups: * @ResourceReference@ entities are @Ref@ intrinsic functions that refer to resources in the template, such as @{ "Ref" : "MyEC2InstanceResource" }@ . * @ParameterReference@ entities are @Ref@ intrinsic functions that get template parameter values, such as @{ "Ref" : "MyPasswordParameter" }@ . * @ResourceAttribute@ entities are @Fn::GetAtt@ intrinsic functions that get resource attribute values, such as @{ "Fn::GetAtt" : [ "MyEC2InstanceResource", "PublicDnsName" ] }@ . * @DirectModification@ entities are changes that are made directly to the template. * @Automatic@ entities are @AWS::CloudFormation::Stack@ resource types, which are also known as nested stacks. If you made no changes to the @AWS::CloudFormation::Stack@ resource, AWS CloudFormation sets the @ChangeSource@ to @Automatic@ because the nested stack's template might have changed. Changes to a nested stack's template aren't visible to AWS CloudFormation until you run an update on the parent stack. ----- * 'rcdEvaluation'+-- * 'rcdEvaluation' - Indicates whether AWS CloudFormation can determine the target value, and whether the target value will change before you execute a change set. For @Static@ evaluations, AWS CloudFormation can determine that the target value will change, and its value. For example, if you directly modify the @InstanceType@ property of an EC2 instance, AWS CloudFormation knows that this property value will change, and its value, so this is a @Static@ evaluation. For @Dynamic@ evaluations, cannot determine the target value because it depends on the result of an intrinsic function, such as a @Ref@ or @Fn::GetAtt@ intrinsic function, when the stack is updated. For example, if your template includes a reference to a resource that is conditionally recreated, the value of the reference (the physical ID of the resource) might change, depending on if the resource is recreated. If the resource is recreated, it will have a new physical ID, so all references to that resource will also be updated. ----- * 'rcdTarget'+-- * 'rcdTarget' - A @ResourceTargetDefinition@ structure that describes the field that AWS CloudFormation will change and whether the resource will be recreated. resourceChangeDetail :: ResourceChangeDetail resourceChangeDetail =@@ -541,36 +608,19 @@ , _rcdTarget = Nothing } --- | The identity of the entity that triggered this change. This entity is a member of the group that is specified by the 'ChangeSource' field. For example, if you modified the value of the 'KeyPairName' parameter, the 'CausingEntity' is the name of the parameter ('KeyPairName').------ If the 'ChangeSource' value is 'DirectModification', no value is given for 'CausingEntity'.+-- | The identity of the entity that triggered this change. This entity is a member of the group that is specified by the @ChangeSource@ field. For example, if you modified the value of the @KeyPairName@ parameter, the @CausingEntity@ is the name of the parameter (@KeyPairName@ ). If the @ChangeSource@ value is @DirectModification@ , no value is given for @CausingEntity@ . rcdCausingEntity :: Lens' ResourceChangeDetail (Maybe Text) rcdCausingEntity = lens _rcdCausingEntity (\ s a -> s{_rcdCausingEntity = a}); --- | The group to which the 'CausingEntity' value belongs. There are five entity groups:------ - 'ResourceReference' entities are 'Ref' intrinsic functions that refer to resources in the template, such as '{ \"Ref\" : \"MyEC2InstanceResource\" }'.------ - 'ParameterReference' entities are 'Ref' intrinsic functions that get template parameter values, such as '{ \"Ref\" : \"MyPasswordParameter\" }'.------ - 'ResourceAttribute' entities are 'Fn::GetAtt' intrinsic functions that get resource attribute values, such as '{ \"Fn::GetAtt\" : [ \"MyEC2InstanceResource\", \"PublicDnsName\" ] }'.------ - 'DirectModification' entities are changes that are made directly to the template.------ - 'Automatic' entities are 'AWS::CloudFormation::Stack' resource types, which are also known as nested stacks. If you made no changes to the 'AWS::CloudFormation::Stack' resource, AWS CloudFormation sets the 'ChangeSource' to 'Automatic' because the nested stack\'s template might have changed. Changes to a nested stack\'s template aren\'t visible to AWS CloudFormation until you run an update on the parent stack.---+-- | The group to which the @CausingEntity@ value belongs. There are five entity groups: * @ResourceReference@ entities are @Ref@ intrinsic functions that refer to resources in the template, such as @{ "Ref" : "MyEC2InstanceResource" }@ . * @ParameterReference@ entities are @Ref@ intrinsic functions that get template parameter values, such as @{ "Ref" : "MyPasswordParameter" }@ . * @ResourceAttribute@ entities are @Fn::GetAtt@ intrinsic functions that get resource attribute values, such as @{ "Fn::GetAtt" : [ "MyEC2InstanceResource", "PublicDnsName" ] }@ . * @DirectModification@ entities are changes that are made directly to the template. * @Automatic@ entities are @AWS::CloudFormation::Stack@ resource types, which are also known as nested stacks. If you made no changes to the @AWS::CloudFormation::Stack@ resource, AWS CloudFormation sets the @ChangeSource@ to @Automatic@ because the nested stack's template might have changed. Changes to a nested stack's template aren't visible to AWS CloudFormation until you run an update on the parent stack. rcdChangeSource :: Lens' ResourceChangeDetail (Maybe ChangeSource) rcdChangeSource = lens _rcdChangeSource (\ s a -> s{_rcdChangeSource = a}); --- | Indicates whether AWS CloudFormation can determine the target value, and whether the target value will change before you execute a change set.------ For 'Static' evaluations, AWS CloudFormation can determine that the target value will change, and its value. For example, if you directly modify the 'InstanceType' property of an EC2 instance, AWS CloudFormation knows that this property value will change, and its value, so this is a 'Static' evaluation.------ For 'Dynamic' evaluations, cannot determine the target value because it depends on the result of an intrinsic function, such as a 'Ref' or 'Fn::GetAtt' intrinsic function, when the stack is updated. For example, if your template includes a reference to a resource that is conditionally recreated, the value of the reference (the physical ID of the resource) might change, depending on if the resource is recreated. If the resource is recreated, it will have a new physical ID, so all references to that resource will also be updated.+-- | Indicates whether AWS CloudFormation can determine the target value, and whether the target value will change before you execute a change set. For @Static@ evaluations, AWS CloudFormation can determine that the target value will change, and its value. For example, if you directly modify the @InstanceType@ property of an EC2 instance, AWS CloudFormation knows that this property value will change, and its value, so this is a @Static@ evaluation. For @Dynamic@ evaluations, cannot determine the target value because it depends on the result of an intrinsic function, such as a @Ref@ or @Fn::GetAtt@ intrinsic function, when the stack is updated. For example, if your template includes a reference to a resource that is conditionally recreated, the value of the reference (the physical ID of the resource) might change, depending on if the resource is recreated. If the resource is recreated, it will have a new physical ID, so all references to that resource will also be updated. rcdEvaluation :: Lens' ResourceChangeDetail (Maybe EvaluationType) rcdEvaluation = lens _rcdEvaluation (\ s a -> s{_rcdEvaluation = a}); --- | A 'ResourceTargetDefinition' structure that describes the field that AWS CloudFormation will change and whether the resource will be recreated.+-- | A @ResourceTargetDefinition@ structure that describes the field that AWS CloudFormation will change and whether the resource will be recreated. rcdTarget :: Lens' ResourceChangeDetail (Maybe ResourceTargetDefinition) rcdTarget = lens _rcdTarget (\ s a -> s{_rcdTarget = a}); @@ -585,8 +635,10 @@ instance NFData ResourceChangeDetail --- | The field that AWS CloudFormation will change, such as the name of a resource\'s property, and whether the resource will be recreated.+-- | The field that AWS CloudFormation will change, such as the name of a resource's property, and whether the resource will be recreated. --+--+-- -- /See:/ 'resourceTargetDefinition' smart constructor. data ResourceTargetDefinition = ResourceTargetDefinition' { _rtdAttribute :: !(Maybe ResourceAttribute)@@ -598,11 +650,11 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'rtdAttribute'+-- * 'rtdAttribute' - Indicates which resource attribute is triggering this update, such as a change in the resource attribute's @Metadata@ , @Properties@ , or @Tags@ . ----- * 'rtdRequiresRecreation'+-- * 'rtdRequiresRecreation' - If the @Attribute@ value is @Properties@ , indicates whether a change to this property causes the resource to be recreated. The value can be @Never@ , @Always@ , or @Conditionally@ . To determine the conditions for a @Conditionally@ recreation, see the update behavior for that <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html property> in the AWS CloudFormation User Guide. ----- * 'rtdName'+-- * 'rtdName' - If the @Attribute@ value is @Properties@ , the name of the property. For all other attributes, the value is null. resourceTargetDefinition :: ResourceTargetDefinition resourceTargetDefinition =@@ -612,15 +664,15 @@ , _rtdName = Nothing } --- | Indicates which resource attribute is triggering this update, such as a change in the resource attribute\'s 'Metadata', 'Properties', or 'Tags'.+-- | Indicates which resource attribute is triggering this update, such as a change in the resource attribute's @Metadata@ , @Properties@ , or @Tags@ . rtdAttribute :: Lens' ResourceTargetDefinition (Maybe ResourceAttribute) rtdAttribute = lens _rtdAttribute (\ s a -> s{_rtdAttribute = a}); --- | If the 'Attribute' value is 'Properties', indicates whether a change to this property causes the resource to be recreated. The value can be 'Never', 'Always', or 'Conditionally'. To determine the conditions for a 'Conditionally' recreation, see the update behavior for that <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html property> in the AWS CloudFormation User Guide.+-- | If the @Attribute@ value is @Properties@ , indicates whether a change to this property causes the resource to be recreated. The value can be @Never@ , @Always@ , or @Conditionally@ . To determine the conditions for a @Conditionally@ recreation, see the update behavior for that <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html property> in the AWS CloudFormation User Guide. rtdRequiresRecreation :: Lens' ResourceTargetDefinition (Maybe RequiresRecreation) rtdRequiresRecreation = lens _rtdRequiresRecreation (\ s a -> s{_rtdRequiresRecreation = a}); --- | If the 'Attribute' value is 'Properties', the name of the property. For all other attributes, the value is null.+-- | If the @Attribute@ value is @Properties@ , the name of the property. For all other attributes, the value is null. rtdName :: Lens' ResourceTargetDefinition (Maybe Text) rtdName = lens _rtdName (\ s a -> s{_rtdName = a}); @@ -636,12 +688,15 @@ -- | The Stack data type. --+--+-- -- /See:/ 'stack' smart constructor. data Stack = Stack' { _sDisableRollback :: !(Maybe Bool) , _sLastUpdatedTime :: !(Maybe ISO8601) , _sNotificationARNs :: !(Maybe [Text]) , _sStackStatusReason :: !(Maybe Text)+ , _sChangeSetId :: !(Maybe Text) , _sOutputs :: !(Maybe [Output]) , _sParameters :: !(Maybe [Parameter]) , _sStackId :: !(Maybe Text)@@ -649,6 +704,7 @@ , _sCapabilities :: !(Maybe [Capability]) , _sTags :: !(Maybe [Tag]) , _sTimeoutInMinutes :: !(Maybe Nat)+ , _sRoleARN :: !(Maybe Text) , _sStackName :: !Text , _sCreationTime :: !ISO8601 , _sStackStatus :: !StackStatus@@ -658,33 +714,37 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'sDisableRollback'+-- * 'sDisableRollback' - Boolean to enable or disable rollback on stack creation failures: * @true@ : disable rollback * @false@ : enable rollback ----- * 'sLastUpdatedTime'+-- * 'sLastUpdatedTime' - The time the stack was last updated. This field will only be returned if the stack has been updated at least once. ----- * 'sNotificationARNs'+-- * 'sNotificationARNs' - SNS topic ARNs to which stack related events are published. ----- * 'sStackStatusReason'+-- * 'sStackStatusReason' - Success/failure message associated with the stack status. ----- * 'sOutputs'+-- * 'sChangeSetId' - The unique ID of the change set. ----- * 'sParameters'+-- * 'sOutputs' - A list of output structures. ----- * 'sStackId'+-- * 'sParameters' - A list of @Parameter@ structures. ----- * 'sDescription'+-- * 'sStackId' - Unique identifier of the stack. ----- * 'sCapabilities'+-- * 'sDescription' - A user-defined description associated with the stack. ----- * 'sTags'+-- * 'sCapabilities' - The capabilities allowed in the stack. ----- * 'sTimeoutInMinutes'+-- * 'sTags' - A list of @Tag@ s that specify information about the stack. ----- * 'sStackName'+-- * 'sTimeoutInMinutes' - The amount of time within which stack creation should complete. ----- * 'sCreationTime'+-- * 'sRoleARN' - The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that is associated with the stack. During a stack operation, AWS CloudFormation uses this role's credentials to make calls on your behalf. ----- * 'sStackStatus'+-- * 'sStackName' - The name associated with the stack.+--+-- * 'sCreationTime' - The time at which the stack was created.+--+-- * 'sStackStatus' - Current status of the stack. stack :: Text -- ^ 'sStackName' -> UTCTime -- ^ 'sCreationTime'@@ -696,6 +756,7 @@ , _sLastUpdatedTime = Nothing , _sNotificationARNs = Nothing , _sStackStatusReason = Nothing+ , _sChangeSetId = Nothing , _sOutputs = Nothing , _sParameters = Nothing , _sStackId = Nothing@@ -703,17 +764,13 @@ , _sCapabilities = Nothing , _sTags = Nothing , _sTimeoutInMinutes = Nothing+ , _sRoleARN = Nothing , _sStackName = pStackName_ , _sCreationTime = _Time # pCreationTime_ , _sStackStatus = pStackStatus_ } --- | Boolean to enable or disable rollback on stack creation failures:------ - 'true': disable rollback------ - 'false': enable rollback---+-- | Boolean to enable or disable rollback on stack creation failures: * @true@ : disable rollback * @false@ : enable rollback sDisableRollback :: Lens' Stack (Maybe Bool) sDisableRollback = lens _sDisableRollback (\ s a -> s{_sDisableRollback = a}); @@ -725,15 +782,19 @@ sNotificationARNs :: Lens' Stack [Text] sNotificationARNs = lens _sNotificationARNs (\ s a -> s{_sNotificationARNs = a}) . _Default . _Coerce; --- | Success\/failure message associated with the stack status.+-- | Success/failure message associated with the stack status. sStackStatusReason :: Lens' Stack (Maybe Text) sStackStatusReason = lens _sStackStatusReason (\ s a -> s{_sStackStatusReason = a}); +-- | The unique ID of the change set.+sChangeSetId :: Lens' Stack (Maybe Text)+sChangeSetId = lens _sChangeSetId (\ s a -> s{_sChangeSetId = a});+ -- | A list of output structures. sOutputs :: Lens' Stack [Output] sOutputs = lens _sOutputs (\ s a -> s{_sOutputs = a}) . _Default . _Coerce; --- | A list of 'Parameter' structures.+-- | A list of @Parameter@ structures. sParameters :: Lens' Stack [Parameter] sParameters = lens _sParameters (\ s a -> s{_sParameters = a}) . _Default . _Coerce; @@ -749,7 +810,7 @@ sCapabilities :: Lens' Stack [Capability] sCapabilities = lens _sCapabilities (\ s a -> s{_sCapabilities = a}) . _Default . _Coerce; --- | A list of 'Tag's that specify information about the stack.+-- | A list of @Tag@ s that specify information about the stack. sTags :: Lens' Stack [Tag] sTags = lens _sTags (\ s a -> s{_sTags = a}) . _Default . _Coerce; @@ -757,6 +818,10 @@ sTimeoutInMinutes :: Lens' Stack (Maybe Natural) sTimeoutInMinutes = lens _sTimeoutInMinutes (\ s a -> s{_sTimeoutInMinutes = a}) . mapping _Nat; +-- | The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that is associated with the stack. During a stack operation, AWS CloudFormation uses this role's credentials to make calls on your behalf.+sRoleARN :: Lens' Stack (Maybe Text)+sRoleARN = lens _sRoleARN (\ s a -> s{_sRoleARN = a});+ -- | The name associated with the stack. sStackName :: Lens' Stack Text sStackName = lens _sStackName (\ s a -> s{_sStackName = a});@@ -778,6 +843,7 @@ (x .@? "NotificationARNs" .!@ mempty >>= may (parseXMLList "member")) <*> (x .@? "StackStatusReason")+ <*> (x .@? "ChangeSetId") <*> (x .@? "Outputs" .!@ mempty >>= may (parseXMLList "member"))@@ -793,6 +859,7 @@ (x .@? "Tags" .!@ mempty >>= may (parseXMLList "member")) <*> (x .@? "TimeoutInMinutes")+ <*> (x .@? "RoleARN") <*> (x .@ "StackName") <*> (x .@ "CreationTime") <*> (x .@ "StackStatus")@@ -803,6 +870,8 @@ -- | The StackEvent data type. --+--+-- -- /See:/ 'stackEvent' smart constructor. data StackEvent = StackEvent' { _seLogicalResourceId :: !(Maybe Text)@@ -821,25 +890,25 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'seLogicalResourceId'+-- * 'seLogicalResourceId' - The logical name of the resource specified in the template. ----- * 'sePhysicalResourceId'+-- * 'sePhysicalResourceId' - The name or unique identifier associated with the physical instance of the resource. ----- * 'seResourceType'+-- * 'seResourceType' - Type of resource. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html AWS Resource Types Reference> in the AWS CloudFormation User Guide.) ----- * 'seResourceStatusReason'+-- * 'seResourceStatusReason' - Success/failure message associated with the resource. ----- * 'seResourceProperties'+-- * 'seResourceProperties' - BLOB of the properties used to create the resource. ----- * 'seResourceStatus'+-- * 'seResourceStatus' - Current status of the resource. ----- * 'seStackId'+-- * 'seStackId' - The unique ID name of the instance of the stack. ----- * 'seEventId'+-- * 'seEventId' - The unique ID of this event. ----- * 'seStackName'+-- * 'seStackName' - The name associated with a stack. ----- * 'seTimestamp'+-- * 'seTimestamp' - Time the status was updated. stackEvent :: Text -- ^ 'seStackId' -> Text -- ^ 'seEventId'@@ -872,7 +941,7 @@ seResourceType :: Lens' StackEvent (Maybe Text) seResourceType = lens _seResourceType (\ s a -> s{_seResourceType = a}); --- | Success\/failure message associated with the resource.+-- | Success/failure message associated with the resource. seResourceStatusReason :: Lens' StackEvent (Maybe Text) seResourceStatusReason = lens _seResourceStatusReason (\ s a -> s{_seResourceStatusReason = a}); @@ -920,6 +989,8 @@ -- | The StackResource data type. --+--+-- -- /See:/ 'stackResource' smart constructor. data StackResource = StackResource' { _srPhysicalResourceId :: !(Maybe Text)@@ -937,23 +1008,23 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'srPhysicalResourceId'+-- * 'srPhysicalResourceId' - The name or unique identifier that corresponds to a physical instance ID of a resource supported by AWS CloudFormation. ----- * 'srResourceStatusReason'+-- * 'srResourceStatusReason' - Success/failure message associated with the resource. ----- * 'srStackId'+-- * 'srStackId' - Unique identifier of the stack. ----- * 'srDescription'+-- * 'srDescription' - User defined description associated with the resource. ----- * 'srStackName'+-- * 'srStackName' - The name associated with the stack. ----- * 'srLogicalResourceId'+-- * 'srLogicalResourceId' - The logical name of the resource specified in the template. ----- * 'srResourceType'+-- * 'srResourceType' - Type of resource. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html AWS Resource Types Reference> in the AWS CloudFormation User Guide.) ----- * 'srTimestamp'+-- * 'srTimestamp' - Time the status was updated. ----- * 'srResourceStatus'+-- * 'srResourceStatus' - Current status of the resource. stackResource :: Text -- ^ 'srLogicalResourceId' -> Text -- ^ 'srResourceType'@@ -977,7 +1048,7 @@ srPhysicalResourceId :: Lens' StackResource (Maybe Text) srPhysicalResourceId = lens _srPhysicalResourceId (\ s a -> s{_srPhysicalResourceId = a}); --- | Success\/failure message associated with the resource.+-- | Success/failure message associated with the resource. srResourceStatusReason :: Lens' StackResource (Maybe Text) srResourceStatusReason = lens _srResourceStatusReason (\ s a -> s{_srResourceStatusReason = a}); @@ -1028,6 +1099,8 @@ -- | Contains detailed information about the specified stack resource. --+--+-- -- /See:/ 'stackResourceDetail' smart constructor. data StackResourceDetail = StackResourceDetail' { _srdPhysicalResourceId :: !(Maybe Text)@@ -1046,25 +1119,25 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'srdPhysicalResourceId'+-- * 'srdPhysicalResourceId' - The name or unique identifier that corresponds to a physical instance ID of a resource supported by AWS CloudFormation. ----- * 'srdResourceStatusReason'+-- * 'srdResourceStatusReason' - Success/failure message associated with the resource. ----- * 'srdMetadata'+-- * 'srdMetadata' - The content of the @Metadata@ attribute declared for the resource. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-metadata.html Metadata Attribute> in the AWS CloudFormation User Guide. ----- * 'srdStackId'+-- * 'srdStackId' - Unique identifier of the stack. ----- * 'srdDescription'+-- * 'srdDescription' - User defined description associated with the resource. ----- * 'srdStackName'+-- * 'srdStackName' - The name associated with the stack. ----- * 'srdLogicalResourceId'+-- * 'srdLogicalResourceId' - The logical name of the resource specified in the template. ----- * 'srdResourceType'+-- * 'srdResourceType' - Type of resource. ((For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html AWS Resource Types Reference> in the AWS CloudFormation User Guide.) ----- * 'srdLastUpdatedTimestamp'+-- * 'srdLastUpdatedTimestamp' - Time the status was updated. ----- * 'srdResourceStatus'+-- * 'srdResourceStatus' - Current status of the resource. stackResourceDetail :: Text -- ^ 'srdLogicalResourceId' -> Text -- ^ 'srdResourceType'@@ -1089,11 +1162,11 @@ srdPhysicalResourceId :: Lens' StackResourceDetail (Maybe Text) srdPhysicalResourceId = lens _srdPhysicalResourceId (\ s a -> s{_srdPhysicalResourceId = a}); --- | Success\/failure message associated with the resource.+-- | Success/failure message associated with the resource. srdResourceStatusReason :: Lens' StackResourceDetail (Maybe Text) srdResourceStatusReason = lens _srdResourceStatusReason (\ s a -> s{_srdResourceStatusReason = a}); --- | The JSON format content of the 'Metadata' attribute declared for the resource. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-metadata.html Metadata Attribute> in the AWS CloudFormation User Guide.+-- | The content of the @Metadata@ attribute declared for the resource. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-metadata.html Metadata Attribute> in the AWS CloudFormation User Guide. srdMetadata :: Lens' StackResourceDetail (Maybe Text) srdMetadata = lens _srdMetadata (\ s a -> s{_srdMetadata = a}); @@ -1145,6 +1218,8 @@ -- | Contains high-level information about the specified stack resource. --+--+-- -- /See:/ 'stackResourceSummary' smart constructor. data StackResourceSummary = StackResourceSummary' { _srsPhysicalResourceId :: !(Maybe Text)@@ -1159,17 +1234,17 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'srsPhysicalResourceId'+-- * 'srsPhysicalResourceId' - The name or unique identifier that corresponds to a physical instance ID of the resource. ----- * 'srsResourceStatusReason'+-- * 'srsResourceStatusReason' - Success/failure message associated with the resource. ----- * 'srsLogicalResourceId'+-- * 'srsLogicalResourceId' - The logical name of the resource specified in the template. ----- * 'srsResourceType'+-- * 'srsResourceType' - Type of resource. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html AWS Resource Types Reference> in the AWS CloudFormation User Guide.) ----- * 'srsLastUpdatedTimestamp'+-- * 'srsLastUpdatedTimestamp' - Time the status was updated. ----- * 'srsResourceStatus'+-- * 'srsResourceStatus' - Current status of the resource. stackResourceSummary :: Text -- ^ 'srsLogicalResourceId' -> Text -- ^ 'srsResourceType'@@ -1190,7 +1265,7 @@ srsPhysicalResourceId :: Lens' StackResourceSummary (Maybe Text) srsPhysicalResourceId = lens _srsPhysicalResourceId (\ s a -> s{_srsPhysicalResourceId = a}); --- | Success\/failure message associated with the resource.+-- | Success/failure message associated with the resource. srsResourceStatusReason :: Lens' StackResourceSummary (Maybe Text) srsResourceStatusReason = lens _srsResourceStatusReason (\ s a -> s{_srsResourceStatusReason = a}); @@ -1226,6 +1301,8 @@ -- | The StackSummary Data Type --+--+-- -- /See:/ 'stackSummary' smart constructor. data StackSummary = StackSummary' { _ssLastUpdatedTime :: !(Maybe ISO8601)@@ -1242,21 +1319,21 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'ssLastUpdatedTime'+-- * 'ssLastUpdatedTime' - The time the stack was last updated. This field will only be returned if the stack has been updated at least once. ----- * 'ssStackStatusReason'+-- * 'ssStackStatusReason' - Success/Failure message associated with the stack status. ----- * 'ssTemplateDescription'+-- * 'ssTemplateDescription' - The template description of the template used to create the stack. ----- * 'ssDeletionTime'+-- * 'ssDeletionTime' - The time the stack was deleted. ----- * 'ssStackId'+-- * 'ssStackId' - Unique stack identifier. ----- * 'ssStackName'+-- * 'ssStackName' - The name associated with the stack. ----- * 'ssCreationTime'+-- * 'ssCreationTime' - The time the stack was created. ----- * 'ssStackStatus'+-- * 'ssStackStatus' - The current status of the stack. stackSummary :: Text -- ^ 'ssStackName' -> UTCTime -- ^ 'ssCreationTime'@@ -1278,7 +1355,7 @@ ssLastUpdatedTime :: Lens' StackSummary (Maybe UTCTime) ssLastUpdatedTime = lens _ssLastUpdatedTime (\ s a -> s{_ssLastUpdatedTime = a}) . mapping _Time; --- | Success\/Failure message associated with the stack status.+-- | Success/Failure message associated with the stack status. ssStackStatusReason :: Lens' StackSummary (Maybe Text) ssStackStatusReason = lens _ssStackStatusReason (\ s a -> s{_ssStackStatusReason = a}); @@ -1324,6 +1401,8 @@ -- | The Tag type enables you to specify a key-value pair that can be used to store information about an AWS CloudFormation stack. --+--+-- -- /See:/ 'tag' smart constructor. data Tag = Tag' { _tagValue :: !(Maybe Text)@@ -1334,9 +1413,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'tagValue'+-- * 'tagValue' - /Required/ . A string containing the value for this tag. You can specify a maximum of 256 characters for a tag value. ----- * 'tagKey'+-- * 'tagKey' - /Required/ . A string used to identify this tag. You can specify a maximum of 128 characters for a tag key. Tags owned by Amazon Web Services (AWS) have the reserved prefix: @aws:@ . tag :: Tag tag =@@ -1345,11 +1424,11 @@ , _tagKey = Nothing } --- | /Required/. A string containing the value for this tag. You can specify a maximum of 256 characters for a tag value.+-- | /Required/ . A string containing the value for this tag. You can specify a maximum of 256 characters for a tag value. tagValue :: Lens' Tag (Maybe Text) tagValue = lens _tagValue (\ s a -> s{_tagValue = a}); --- | /Required/. A string used to identify this tag. You can specify a maximum of 128 characters for a tag key. Tags owned by Amazon Web Services (AWS) have the reserved prefix: 'aws:'.+-- | /Required/ . A string used to identify this tag. You can specify a maximum of 128 characters for a tag key. Tags owned by Amazon Web Services (AWS) have the reserved prefix: @aws:@ . tagKey :: Lens' Tag (Maybe Text) tagKey = lens _tagKey (\ s a -> s{_tagKey = a}); @@ -1367,6 +1446,8 @@ -- | The TemplateParameter data type. --+--+-- -- /See:/ 'templateParameter' smart constructor. data TemplateParameter = TemplateParameter' { _tpParameterKey :: !(Maybe Text)@@ -1379,13 +1460,13 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'tpParameterKey'+-- * 'tpParameterKey' - The name associated with the parameter. ----- * 'tpDefaultValue'+-- * 'tpDefaultValue' - The default value associated with the parameter. ----- * 'tpNoEcho'+-- * 'tpNoEcho' - Flag indicating whether the parameter should be displayed as plain text in logs and UIs. ----- * 'tpDescription'+-- * 'tpDescription' - User defined description associated with the parameter. templateParameter :: TemplateParameter templateParameter =
gen/Network/AWS/CloudFormation/Types/Sum.hs view
@@ -109,6 +109,29 @@ instance FromXML ChangeSetStatus where parseXML = parseXMLText "ChangeSetStatus" +data ChangeSetType+ = Create+ | Update+ deriving (Eq,Ord,Read,Show,Enum,Bounded,Data,Typeable,Generic)++instance FromText ChangeSetType where+ parser = takeLowerText >>= \case+ "create" -> pure Create+ "update" -> pure Update+ e -> fromTextError $ "Failure parsing ChangeSetType from value: '" <> e+ <> "'. Accepted values: create, update"++instance ToText ChangeSetType where+ toText = \case+ Create -> "CREATE"+ Update -> "UPDATE"++instance Hashable ChangeSetType+instance NFData ChangeSetType+instance ToByteString ChangeSetType+instance ToQuery ChangeSetType+instance ToHeader ChangeSetType+ data ChangeSource = Automatic | DirectModification@@ -433,6 +456,7 @@ | SSDeleteComplete | SSDeleteFailed | SSDeleteInProgress+ | SSReviewInProgress | SSRollbackComplete | SSRollbackFailed | SSRollbackInProgress@@ -453,6 +477,7 @@ "delete_complete" -> pure SSDeleteComplete "delete_failed" -> pure SSDeleteFailed "delete_in_progress" -> pure SSDeleteInProgress+ "review_in_progress" -> pure SSReviewInProgress "rollback_complete" -> pure SSRollbackComplete "rollback_failed" -> pure SSRollbackFailed "rollback_in_progress" -> pure SSRollbackInProgress@@ -464,7 +489,7 @@ "update_rollback_failed" -> pure SSUpdateRollbackFailed "update_rollback_in_progress" -> pure SSUpdateRollbackInProgress e -> fromTextError $ "Failure parsing StackStatus from value: '" <> e- <> "'. Accepted values: create_complete, create_failed, create_in_progress, delete_complete, delete_failed, delete_in_progress, rollback_complete, rollback_failed, rollback_in_progress, update_complete, update_complete_cleanup_in_progress, update_in_progress, update_rollback_complete, update_rollback_complete_cleanup_in_progress, update_rollback_failed, update_rollback_in_progress"+ <> "'. Accepted values: create_complete, create_failed, create_in_progress, delete_complete, delete_failed, delete_in_progress, review_in_progress, rollback_complete, rollback_failed, rollback_in_progress, update_complete, update_complete_cleanup_in_progress, update_in_progress, update_rollback_complete, update_rollback_complete_cleanup_in_progress, update_rollback_failed, update_rollback_in_progress" instance ToText StackStatus where toText = \case@@ -474,6 +499,7 @@ SSDeleteComplete -> "DELETE_COMPLETE" SSDeleteFailed -> "DELETE_FAILED" SSDeleteInProgress -> "DELETE_IN_PROGRESS"+ SSReviewInProgress -> "REVIEW_IN_PROGRESS" SSRollbackComplete -> "ROLLBACK_COMPLETE" SSRollbackFailed -> "ROLLBACK_FAILED" SSRollbackInProgress -> "ROLLBACK_IN_PROGRESS"@@ -493,3 +519,29 @@ instance FromXML StackStatus where parseXML = parseXMLText "StackStatus"++data TemplateStage+ = Original+ | Processed+ deriving (Eq,Ord,Read,Show,Enum,Bounded,Data,Typeable,Generic)++instance FromText TemplateStage where+ parser = takeLowerText >>= \case+ "original" -> pure Original+ "processed" -> pure Processed+ e -> fromTextError $ "Failure parsing TemplateStage from value: '" <> e+ <> "'. Accepted values: original, processed"++instance ToText TemplateStage where+ toText = \case+ Original -> "Original"+ Processed -> "Processed"++instance Hashable TemplateStage+instance NFData TemplateStage+instance ToByteString TemplateStage+instance ToQuery TemplateStage+instance ToHeader TemplateStage++instance FromXML TemplateStage where+ parseXML = parseXMLText "TemplateStage"
gen/Network/AWS/CloudFormation/UpdateStack.hs view
@@ -18,11 +18,13 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- Updates a stack as specified in the template. After the call completes successfully, the stack update starts. You can check the status of the stack via the < DescribeStacks> action.+-- Updates a stack as specified in the template. After the call completes successfully, the stack update starts. You can check the status of the stack via the 'DescribeStacks' action. ----- To get a copy of the template for an existing stack, you can use the < GetTemplate> action. ----- For more information about creating an update template, updating a stack, and monitoring the progress of the update, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks.html Updating a Stack>.+-- To get a copy of the template for an existing stack, you can use the 'GetTemplate' action.+--+-- For more information about creating an update template, updating a stack, and monitoring the progress of the update, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks.html Updating a Stack> .+-- module Network.AWS.CloudFormation.UpdateStack ( -- * Creating a Request@@ -41,6 +43,7 @@ , usCapabilities , usResourceTypes , usTags+ , usRoleARN , usStackName -- * Destructuring the Response@@ -58,8 +61,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for an < UpdateStack> action.+-- | The input for an 'UpdateStack' action. --+--+-- -- /See:/ 'updateStack' smart constructor. data UpdateStack = UpdateStack' { _usUsePreviousTemplate :: !(Maybe Bool)@@ -74,6 +79,7 @@ , _usCapabilities :: !(Maybe [Capability]) , _usResourceTypes :: !(Maybe [Text]) , _usTags :: !(Maybe [Tag])+ , _usRoleARN :: !(Maybe Text) , _usStackName :: !Text } deriving (Eq,Read,Show,Data,Typeable,Generic) @@ -81,31 +87,33 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'usUsePreviousTemplate'+-- * 'usUsePreviousTemplate' - Reuse the existing template that is associated with the stack that you are updating. ----- * 'usNotificationARNs'+-- * 'usNotificationARNs' - Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that AWS CloudFormation associates with the stack. Specify an empty list to remove all notification topics. ----- * 'usStackPolicyBody'+-- * 'usStackPolicyBody' - Structure containing a new stack policy body. You can specify either the @StackPolicyBody@ or the @StackPolicyURL@ parameter, but not both. You might update the stack policy, for example, in order to protect a new resource that you created during a stack update. If you do not specify a stack policy, the current policy that is associated with the stack is unchanged. ----- * 'usStackPolicyDuringUpdateBody'+-- * 'usStackPolicyDuringUpdateBody' - Structure containing the temporary overriding stack policy body. You can specify either the @StackPolicyDuringUpdateBody@ or the @StackPolicyDuringUpdateURL@ parameter, but not both. If you want to update protected resources, specify a temporary overriding stack policy during this update. If you do not specify a stack policy, the current policy that is associated with the stack will be used. ----- * 'usStackPolicyDuringUpdateURL'+-- * 'usStackPolicyDuringUpdateURL' - Location of a file containing the temporary overriding stack policy. The URL must point to a policy (max size: 16KB) located in an S3 bucket in the same region as the stack. You can specify either the @StackPolicyDuringUpdateBody@ or the @StackPolicyDuringUpdateURL@ parameter, but not both. If you want to update protected resources, specify a temporary overriding stack policy during this update. If you do not specify a stack policy, the current policy that is associated with the stack will be used. ----- * 'usParameters'+-- * 'usParameters' - A list of @Parameter@ structures that specify input parameters for the stack. For more information, see the <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html Parameter> data type. ----- * 'usStackPolicyURL'+-- * 'usStackPolicyURL' - Location of a file containing the updated stack policy. The URL must point to a policy (max size: 16KB) located in an S3 bucket in the same region as the stack. You can specify either the @StackPolicyBody@ or the @StackPolicyURL@ parameter, but not both. You might update the stack policy, for example, in order to protect a new resource that you created during a stack update. If you do not specify a stack policy, the current policy that is associated with the stack is unchanged. ----- * 'usTemplateBody'+-- * 'usTemplateBody' - Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.) Conditional: You must specify either the @TemplateBody@ or the @TemplateURL@ parameter, but not both. ----- * 'usTemplateURL'+-- * 'usTemplateURL' - Location of file containing the template body. The URL must point to a template that is located in an Amazon S3 bucket. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must specify either the @TemplateBody@ or the @TemplateURL@ parameter, but not both. ----- * 'usCapabilities'+-- * 'usCapabilities' - A list of values that you must specify before AWS CloudFormation can update certain stacks. Some stack templates might include resources that can affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this parameter. The only valid values are @CAPABILITY_IAM@ and @CAPABILITY_NAMED_IAM@ . The following resources require you to specify this parameter: <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html AWS::IAM::AccessKey> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html AWS::IAM::Group> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html AWS::IAM::InstanceProfile> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html AWS::IAM::Policy> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html AWS::IAM::Role> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html AWS::IAM::User> , and <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html AWS::IAM::UserToGroupAddition> . If your stack template contains these resources, we recommend that you review all permissions associated with them and edit their permissions if necessary. If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify @CAPABILITY_NAMED_IAM@ . If you don't specify this parameter, this action returns an @InsufficientCapabilities@ error. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates> . ----- * 'usResourceTypes'+-- * 'usResourceTypes' - The template resource types that you have permissions to work with for this update stack action, such as @AWS::EC2::Instance@ , @AWS::EC2::*@ , or @Custom::MyCustomInstance@ . If the list of resource types doesn't include a resource that you're updating, the stack update fails. By default, AWS CloudFormation grants permissions to all resource types. AWS Identity and Access Management (IAM) uses this parameter for AWS CloudFormation-specific condition keys in IAM policies. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html Controlling Access with AWS Identity and Access Management> . ----- * 'usTags'+-- * 'usTags' - Key-value pairs to associate with this stack. AWS CloudFormation also propagates these tags to supported resources in the stack. You can specify a maximum number of 10 tags. If you don't specify this parameter, AWS CloudFormation doesn't modify the stack's tags. If you specify an empty value, AWS CloudFormation removes all associated tags. ----- * 'usStackName'+-- * 'usRoleARN' - The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes to update the stack. AWS CloudFormation uses the role's credentials to make calls on your behalf. AWS CloudFormation always uses this role for all future operations on the stack. As long as users have permission to operate on the stack, AWS CloudFormation uses this role even if the users don't have permission to pass it. Ensure that the role grants least privilege. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.+--+-- * 'usStackName' - The name or unique stack ID of the stack to update. updateStack :: Text -- ^ 'usStackName' -> UpdateStack@@ -123,6 +131,7 @@ , _usCapabilities = Nothing , _usResourceTypes = Nothing , _usTags = Nothing+ , _usRoleARN = Nothing , _usStackName = pStackName_ } @@ -134,68 +143,50 @@ usNotificationARNs :: Lens' UpdateStack [Text] usNotificationARNs = lens _usNotificationARNs (\ s a -> s{_usNotificationARNs = a}) . _Default . _Coerce; --- | Structure containing a new stack policy body. You can specify either the 'StackPolicyBody' or the 'StackPolicyURL' parameter, but not both.------ You might update the stack policy, for example, in order to protect a new resource that you created during a stack update. If you do not specify a stack policy, the current policy that is associated with the stack is unchanged.+-- | Structure containing a new stack policy body. You can specify either the @StackPolicyBody@ or the @StackPolicyURL@ parameter, but not both. You might update the stack policy, for example, in order to protect a new resource that you created during a stack update. If you do not specify a stack policy, the current policy that is associated with the stack is unchanged. usStackPolicyBody :: Lens' UpdateStack (Maybe Text) usStackPolicyBody = lens _usStackPolicyBody (\ s a -> s{_usStackPolicyBody = a}); --- | Structure containing the temporary overriding stack policy body. You can specify either the 'StackPolicyDuringUpdateBody' or the 'StackPolicyDuringUpdateURL' parameter, but not both.------ If you want to update protected resources, specify a temporary overriding stack policy during this update. If you do not specify a stack policy, the current policy that is associated with the stack will be used.+-- | Structure containing the temporary overriding stack policy body. You can specify either the @StackPolicyDuringUpdateBody@ or the @StackPolicyDuringUpdateURL@ parameter, but not both. If you want to update protected resources, specify a temporary overriding stack policy during this update. If you do not specify a stack policy, the current policy that is associated with the stack will be used. usStackPolicyDuringUpdateBody :: Lens' UpdateStack (Maybe Text) usStackPolicyDuringUpdateBody = lens _usStackPolicyDuringUpdateBody (\ s a -> s{_usStackPolicyDuringUpdateBody = a}); --- | Location of a file containing the temporary overriding stack policy. The URL must point to a policy (max size: 16KB) located in an S3 bucket in the same region as the stack. You can specify either the 'StackPolicyDuringUpdateBody' or the 'StackPolicyDuringUpdateURL' parameter, but not both.------ If you want to update protected resources, specify a temporary overriding stack policy during this update. If you do not specify a stack policy, the current policy that is associated with the stack will be used.+-- | Location of a file containing the temporary overriding stack policy. The URL must point to a policy (max size: 16KB) located in an S3 bucket in the same region as the stack. You can specify either the @StackPolicyDuringUpdateBody@ or the @StackPolicyDuringUpdateURL@ parameter, but not both. If you want to update protected resources, specify a temporary overriding stack policy during this update. If you do not specify a stack policy, the current policy that is associated with the stack will be used. usStackPolicyDuringUpdateURL :: Lens' UpdateStack (Maybe Text) usStackPolicyDuringUpdateURL = lens _usStackPolicyDuringUpdateURL (\ s a -> s{_usStackPolicyDuringUpdateURL = a}); --- | A list of 'Parameter' structures that specify input parameters for the stack. For more information, see the <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html Parameter> data type.+-- | A list of @Parameter@ structures that specify input parameters for the stack. For more information, see the <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html Parameter> data type. usParameters :: Lens' UpdateStack [Parameter] usParameters = lens _usParameters (\ s a -> s{_usParameters = a}) . _Default . _Coerce; --- | Location of a file containing the updated stack policy. The URL must point to a policy (max size: 16KB) located in an S3 bucket in the same region as the stack. You can specify either the 'StackPolicyBody' or the 'StackPolicyURL' parameter, but not both.------ You might update the stack policy, for example, in order to protect a new resource that you created during a stack update. If you do not specify a stack policy, the current policy that is associated with the stack is unchanged.+-- | Location of a file containing the updated stack policy. The URL must point to a policy (max size: 16KB) located in an S3 bucket in the same region as the stack. You can specify either the @StackPolicyBody@ or the @StackPolicyURL@ parameter, but not both. You might update the stack policy, for example, in order to protect a new resource that you created during a stack update. If you do not specify a stack policy, the current policy that is associated with the stack is unchanged. usStackPolicyURL :: Lens' UpdateStack (Maybe Text) usStackPolicyURL = lens _usStackPolicyURL (\ s a -> s{_usStackPolicyURL = a}); --- | Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.)------ Conditional: You must specify either the 'TemplateBody' or the 'TemplateURL' parameter, but not both.+-- | Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.) Conditional: You must specify either the @TemplateBody@ or the @TemplateURL@ parameter, but not both. usTemplateBody :: Lens' UpdateStack (Maybe Text) usTemplateBody = lens _usTemplateBody (\ s a -> s{_usTemplateBody = a}); --- | Location of file containing the template body. The URL must point to a template that is located in an Amazon S3 bucket. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.------ Conditional: You must specify either the 'TemplateBody' or the 'TemplateURL' parameter, but not both.+-- | Location of file containing the template body. The URL must point to a template that is located in an Amazon S3 bucket. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must specify either the @TemplateBody@ or the @TemplateURL@ parameter, but not both. usTemplateURL :: Lens' UpdateStack (Maybe Text) usTemplateURL = lens _usTemplateURL (\ s a -> s{_usTemplateURL = a}); --- | A list of values that you must specify before AWS CloudFormation can update certain stacks. Some stack templates might include resources that can affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this parameter.------ The only valid values are 'CAPABILITY_IAM' and 'CAPABILITY_NAMED_IAM'. The following resources require you to specify this parameter: <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html AWS::IAM::AccessKey>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html AWS::IAM::Group>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html AWS::IAM::InstanceProfile>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html AWS::IAM::Policy>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html AWS::IAM::Role>, <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html AWS::IAM::User>, and <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html AWS::IAM::UserToGroupAddition>. If your stack template contains these resources, we recommend that you review all permissions associated with them and edit their permissions if necessary.------ If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify 'CAPABILITY_NAMED_IAM'. If you don\'t specify this parameter, this action returns an 'InsufficientCapabilities' error.------ For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates>.+-- | A list of values that you must specify before AWS CloudFormation can update certain stacks. Some stack templates might include resources that can affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this parameter. The only valid values are @CAPABILITY_IAM@ and @CAPABILITY_NAMED_IAM@ . The following resources require you to specify this parameter: <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html AWS::IAM::AccessKey> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html AWS::IAM::Group> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html AWS::IAM::InstanceProfile> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html AWS::IAM::Policy> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html AWS::IAM::Role> , <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html AWS::IAM::User> , and <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html AWS::IAM::UserToGroupAddition> . If your stack template contains these resources, we recommend that you review all permissions associated with them and edit their permissions if necessary. If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify @CAPABILITY_NAMED_IAM@ . If you don't specify this parameter, this action returns an @InsufficientCapabilities@ error. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates> . usCapabilities :: Lens' UpdateStack [Capability] usCapabilities = lens _usCapabilities (\ s a -> s{_usCapabilities = a}) . _Default . _Coerce; --- | The template resource types that you have permissions to work with for this update stack action, such as 'AWS::EC2::Instance', 'AWS::EC2::*', or 'Custom::MyCustomInstance'.------ If the list of resource types doesn\'t include a resource that you\'re updating, the stack update fails. By default, AWS CloudFormation grants permissions to all resource types. AWS Identity and Access Management (IAM) uses this parameter for AWS CloudFormation-specific condition keys in IAM policies. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html Controlling Access with AWS Identity and Access Management>.+-- | The template resource types that you have permissions to work with for this update stack action, such as @AWS::EC2::Instance@ , @AWS::EC2::*@ , or @Custom::MyCustomInstance@ . If the list of resource types doesn't include a resource that you're updating, the stack update fails. By default, AWS CloudFormation grants permissions to all resource types. AWS Identity and Access Management (IAM) uses this parameter for AWS CloudFormation-specific condition keys in IAM policies. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html Controlling Access with AWS Identity and Access Management> . usResourceTypes :: Lens' UpdateStack [Text] usResourceTypes = lens _usResourceTypes (\ s a -> s{_usResourceTypes = a}) . _Default . _Coerce; --- | Key-value pairs to associate with this stack. AWS CloudFormation also propagates these tags to supported resources in the stack. You can specify a maximum number of 10 tags.------ If you don\'t specify this parameter, AWS CloudFormation doesn\'t modify the stack\'s tags. If you specify an empty value, AWS CloudFormation removes all associated tags.+-- | Key-value pairs to associate with this stack. AWS CloudFormation also propagates these tags to supported resources in the stack. You can specify a maximum number of 10 tags. If you don't specify this parameter, AWS CloudFormation doesn't modify the stack's tags. If you specify an empty value, AWS CloudFormation removes all associated tags. usTags :: Lens' UpdateStack [Tag] usTags = lens _usTags (\ s a -> s{_usTags = a}) . _Default . _Coerce; +-- | The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes to update the stack. AWS CloudFormation uses the role's credentials to make calls on your behalf. AWS CloudFormation always uses this role for all future operations on the stack. As long as users have permission to operate on the stack, AWS CloudFormation uses this role even if the users don't have permission to pass it. Ensure that the role grants least privilege. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.+usRoleARN :: Lens' UpdateStack (Maybe Text)+usRoleARN = lens _usRoleARN (\ s a -> s{_usRoleARN = a});+ -- | The name or unique stack ID of the stack to update. usStackName :: Lens' UpdateStack Text usStackName = lens _usStackName (\ s a -> s{_usStackName = a});@@ -243,10 +234,12 @@ "ResourceTypes" =: toQuery (toQueryList "member" <$> _usResourceTypes), "Tags" =: toQuery (toQueryList "member" <$> _usTags),- "StackName" =: _usStackName]+ "RoleARN" =: _usRoleARN, "StackName" =: _usStackName] --- | The output for an < UpdateStack> action.+-- | The output for an 'UpdateStack' action. --+--+-- -- /See:/ 'updateStackResponse' smart constructor. data UpdateStackResponse = UpdateStackResponse' { _usrsStackId :: !(Maybe Text)@@ -257,9 +250,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'usrsStackId'+-- * 'usrsStackId' - Unique identifier of the stack. ----- * 'usrsResponseStatus'+-- * 'usrsResponseStatus' - -- | The response status code. updateStackResponse :: Int -- ^ 'usrsResponseStatus' -> UpdateStackResponse@@ -273,7 +266,7 @@ usrsStackId :: Lens' UpdateStackResponse (Maybe Text) usrsStackId = lens _usrsStackId (\ s a -> s{_usrsStackId = a}); --- | The response status code.+-- | -- | The response status code. usrsResponseStatus :: Lens' UpdateStackResponse Int usrsResponseStatus = lens _usrsResponseStatus (\ s a -> s{_usrsResponseStatus = a});
gen/Network/AWS/CloudFormation/ValidateTemplate.hs view
@@ -18,7 +18,9 @@ -- Stability : auto-generated -- Portability : non-portable (GHC extensions) ----- Validates a specified template.+-- Validates a specified template. AWS CloudFormation first checks if the template is valid JSON. If it isn't, AWS CloudFormation checks if the template is valid YAML. If both these checks fail, AWS CloudFormation returns a template validation error.+--+-- module Network.AWS.CloudFormation.ValidateTemplate ( -- * Creating a Request@@ -32,6 +34,7 @@ , validateTemplateResponse , ValidateTemplateResponse -- * Response Lenses+ , vtrsDeclaredTransforms , vtrsCapabilitiesReason , vtrsParameters , vtrsDescription@@ -46,8 +49,10 @@ import Network.AWS.Request import Network.AWS.Response --- | The input for < ValidateTemplate> action.+-- | The input for 'ValidateTemplate' action. --+--+-- -- /See:/ 'validateTemplate' smart constructor. data ValidateTemplate = ValidateTemplate' { _vtTemplateBody :: !(Maybe Text)@@ -58,9 +63,9 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'vtTemplateBody'+-- * 'vtTemplateBody' - Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must pass @TemplateURL@ or @TemplateBody@ . If both are passed, only @TemplateBody@ is used. ----- * 'vtTemplateURL'+-- * 'vtTemplateURL' - Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must pass @TemplateURL@ or @TemplateBody@ . If both are passed, only @TemplateBody@ is used. validateTemplate :: ValidateTemplate validateTemplate =@@ -69,15 +74,11 @@ , _vtTemplateURL = Nothing } --- | Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.------ Conditional: You must pass 'TemplateURL' or 'TemplateBody'. If both are passed, only 'TemplateBody' is used.+-- | Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must pass @TemplateURL@ or @TemplateBody@ . If both are passed, only @TemplateBody@ is used. vtTemplateBody :: Lens' ValidateTemplate (Maybe Text) vtTemplateBody = lens _vtTemplateBody (\ s a -> s{_vtTemplateBody = a}); --- | Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide.------ Conditional: You must pass 'TemplateURL' or 'TemplateBody'. If both are passed, only 'TemplateBody' is used.+-- | Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html Template Anatomy> in the AWS CloudFormation User Guide. Conditional: You must pass @TemplateURL@ or @TemplateBody@ . If both are passed, only @TemplateBody@ is used. vtTemplateURL :: Lens' ValidateTemplate (Maybe Text) vtTemplateURL = lens _vtTemplateURL (\ s a -> s{_vtTemplateURL = a}); @@ -88,7 +89,10 @@ = receiveXMLWrapper "ValidateTemplateResult" (\ s h x -> ValidateTemplateResponse' <$>- (x .@? "CapabilitiesReason") <*>+ (x .@? "DeclaredTransforms" .!@ mempty >>=+ may (parseXMLList "member"))+ <*> (x .@? "CapabilitiesReason")+ <*> (x .@? "Parameters" .!@ mempty >>= may (parseXMLList "member")) <*> (x .@? "Description")@@ -115,11 +119,14 @@ "TemplateBody" =: _vtTemplateBody, "TemplateURL" =: _vtTemplateURL] --- | The output for < ValidateTemplate> action.+-- | The output for 'ValidateTemplate' action. --+--+-- -- /See:/ 'validateTemplateResponse' smart constructor. data ValidateTemplateResponse = ValidateTemplateResponse'- { _vtrsCapabilitiesReason :: !(Maybe Text)+ { _vtrsDeclaredTransforms :: !(Maybe [Text])+ , _vtrsCapabilitiesReason :: !(Maybe Text) , _vtrsParameters :: !(Maybe [TemplateParameter]) , _vtrsDescription :: !(Maybe Text) , _vtrsCapabilities :: !(Maybe [Capability])@@ -130,32 +137,39 @@ -- -- Use one of the following lenses to modify other fields as desired: ----- * 'vtrsCapabilitiesReason'+-- * 'vtrsDeclaredTransforms' - A list of the transforms that are declared in the template. ----- * 'vtrsParameters'+-- * 'vtrsCapabilitiesReason' - The list of resources that generated the values in the @Capabilities@ response element. ----- * 'vtrsDescription'+-- * 'vtrsParameters' - A list of @TemplateParameter@ structures. ----- * 'vtrsCapabilities'+-- * 'vtrsDescription' - The description found within the template. ----- * 'vtrsResponseStatus'+-- * 'vtrsCapabilities' - The capabilities found within the template. If your template contains IAM resources, you must specify the CAPABILITY_IAM or CAPABILITY_NAMED_IAM value for this parameter when you use the 'CreateStack' or 'UpdateStack' actions with your template; otherwise, those actions return an InsufficientCapabilities error. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates> .+--+-- * 'vtrsResponseStatus' - -- | The response status code. validateTemplateResponse :: Int -- ^ 'vtrsResponseStatus' -> ValidateTemplateResponse validateTemplateResponse pResponseStatus_ = ValidateTemplateResponse'- { _vtrsCapabilitiesReason = Nothing+ { _vtrsDeclaredTransforms = Nothing+ , _vtrsCapabilitiesReason = Nothing , _vtrsParameters = Nothing , _vtrsDescription = Nothing , _vtrsCapabilities = Nothing , _vtrsResponseStatus = pResponseStatus_ } --- | The list of resources that generated the values in the 'Capabilities' response element.+-- | A list of the transforms that are declared in the template.+vtrsDeclaredTransforms :: Lens' ValidateTemplateResponse [Text]+vtrsDeclaredTransforms = lens _vtrsDeclaredTransforms (\ s a -> s{_vtrsDeclaredTransforms = a}) . _Default . _Coerce;++-- | The list of resources that generated the values in the @Capabilities@ response element. vtrsCapabilitiesReason :: Lens' ValidateTemplateResponse (Maybe Text) vtrsCapabilitiesReason = lens _vtrsCapabilitiesReason (\ s a -> s{_vtrsCapabilitiesReason = a}); --- | A list of 'TemplateParameter' structures.+-- | A list of @TemplateParameter@ structures. vtrsParameters :: Lens' ValidateTemplateResponse [TemplateParameter] vtrsParameters = lens _vtrsParameters (\ s a -> s{_vtrsParameters = a}) . _Default . _Coerce; @@ -163,13 +177,11 @@ vtrsDescription :: Lens' ValidateTemplateResponse (Maybe Text) vtrsDescription = lens _vtrsDescription (\ s a -> s{_vtrsDescription = a}); --- | The capabilities found within the template. If your template contains IAM resources, you must specify the CAPABILITY_IAM or CAPABILITY_NAMED_IAM value for this parameter when you use the < CreateStack> or < UpdateStack> actions with your template; otherwise, those actions return an InsufficientCapabilities error.------ For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates>.+-- | The capabilities found within the template. If your template contains IAM resources, you must specify the CAPABILITY_IAM or CAPABILITY_NAMED_IAM value for this parameter when you use the 'CreateStack' or 'UpdateStack' actions with your template; otherwise, those actions return an InsufficientCapabilities error. For more information, see <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities Acknowledging IAM Resources in AWS CloudFormation Templates> . vtrsCapabilities :: Lens' ValidateTemplateResponse [Capability] vtrsCapabilities = lens _vtrsCapabilities (\ s a -> s{_vtrsCapabilities = a}) . _Default . _Coerce; --- | The response status code.+-- | -- | The response status code. vtrsResponseStatus :: Lens' ValidateTemplateResponse Int vtrsResponseStatus = lens _vtrsResponseStatus (\ s a -> s{_vtrsResponseStatus = a});
gen/Network/AWS/CloudFormation/Waiters.hs view
@@ -15,6 +15,7 @@ -- module Network.AWS.CloudFormation.Waiters where +import Network.AWS.CloudFormation.DescribeChangeSet import Network.AWS.CloudFormation.DescribeStacks import Network.AWS.CloudFormation.DescribeStacks import Network.AWS.CloudFormation.DescribeStacks@@ -24,8 +25,7 @@ import Network.AWS.Prelude import Network.AWS.Waiter --- | Polls 'Network.AWS.CloudFormation.DescribeStacks' every 30 seconds until a--- successful state is reached. An error is returned after 120 failed checks.+-- | Polls 'Network.AWS.CloudFormation.DescribeStacks' every 30 seconds until a successful state is reached. An error is returned after 120 failed checks. stackCreateComplete :: Wait DescribeStacks stackCreateComplete = Wait@@ -48,35 +48,24 @@ (folding (concatOf dsrsStacks) . sStackStatus . to toTextCI) , matchAny- "DELETE_IN_PROGRESS"- AcceptFailure- (folding (concatOf dsrsStacks) .- sStackStatus . to toTextCI)- , matchAny "DELETE_FAILED" AcceptFailure (folding (concatOf dsrsStacks) . sStackStatus . to toTextCI) , matchAny- "ROLLBACK_COMPLETE"- AcceptFailure- (folding (concatOf dsrsStacks) .- sStackStatus . to toTextCI)- , matchAny "ROLLBACK_FAILED" AcceptFailure (folding (concatOf dsrsStacks) . sStackStatus . to toTextCI) , matchAny- "ROLLBACK_IN_PROGRESS"+ "ROLLBACK_COMPLETE" AcceptFailure (folding (concatOf dsrsStacks) . sStackStatus . to toTextCI) , matchError "ValidationError" AcceptFailure] } --- | Polls 'Network.AWS.CloudFormation.DescribeStacks' every 30 seconds until a--- successful state is reached. An error is returned after 120 failed checks.+-- | Polls 'Network.AWS.CloudFormation.DescribeStacks' every 30 seconds until a successful state is reached. An error is returned after 120 failed checks. stackUpdateComplete :: Wait DescribeStacks stackUpdateComplete = Wait@@ -94,30 +83,19 @@ (folding (concatOf dsrsStacks) . sStackStatus . to toTextCI) , matchAny- "UPDATE_ROLLBACK_COMPLETE"- AcceptFailure- (folding (concatOf dsrsStacks) .- sStackStatus . to toTextCI)- , matchAny "UPDATE_ROLLBACK_FAILED" AcceptFailure (folding (concatOf dsrsStacks) . sStackStatus . to toTextCI) , matchAny- "UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS"- AcceptFailure- (folding (concatOf dsrsStacks) .- sStackStatus . to toTextCI)- , matchAny- "UPDATE_ROLLBACK_IN_PROGRESS"+ "UPDATE_ROLLBACK_COMPLETE" AcceptFailure (folding (concatOf dsrsStacks) . sStackStatus . to toTextCI) , matchError "ValidationError" AcceptFailure] } --- | Polls 'Network.AWS.CloudFormation.DescribeStacks' every 5 seconds until a--- successful state is reached. An error is returned after 20 failed checks.+-- | Polls 'Network.AWS.CloudFormation.DescribeStacks' every 5 seconds until a successful state is reached. An error is returned after 20 failed checks. stackExists :: Wait DescribeStacks stackExists = Wait@@ -128,8 +106,7 @@ , matchError "ValidationError" AcceptRetry] } --- | Polls 'Network.AWS.CloudFormation.DescribeStacks' every 30 seconds until a--- successful state is reached. An error is returned after 120 failed checks.+-- | Polls 'Network.AWS.CloudFormation.DescribeStacks' every 30 seconds until a successful state is reached. An error is returned after 120 failed checks. stackDeleteComplete :: Wait DescribeStacks stackDeleteComplete = Wait@@ -148,61 +125,16 @@ (folding (concatOf dsrsStacks) . sStackStatus . to toTextCI) , matchAny- "CREATE_COMPLETE"- AcceptFailure- (folding (concatOf dsrsStacks) .- sStackStatus . to toTextCI)- , matchAny "CREATE_FAILED" AcceptFailure (folding (concatOf dsrsStacks) . sStackStatus . to toTextCI) , matchAny- "CREATE_IN_PROGRESS"- AcceptFailure- (folding (concatOf dsrsStacks) .- sStackStatus . to toTextCI)- , matchAny- "ROLLBACK_COMPLETE"- AcceptFailure- (folding (concatOf dsrsStacks) .- sStackStatus . to toTextCI)- , matchAny "ROLLBACK_FAILED" AcceptFailure (folding (concatOf dsrsStacks) . sStackStatus . to toTextCI) , matchAny- "ROLLBACK_IN_PROGRESS"- AcceptFailure- (folding (concatOf dsrsStacks) .- sStackStatus . to toTextCI)- , matchAny- "UPDATE_COMPLETE"- AcceptFailure- (folding (concatOf dsrsStacks) .- sStackStatus . to toTextCI)- , matchAny- "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS"- AcceptFailure- (folding (concatOf dsrsStacks) .- sStackStatus . to toTextCI)- , matchAny- "UPDATE_IN_PROGRESS"- AcceptFailure- (folding (concatOf dsrsStacks) .- sStackStatus . to toTextCI)- , matchAny- "UPDATE_ROLLBACK_COMPLETE"- AcceptFailure- (folding (concatOf dsrsStacks) .- sStackStatus . to toTextCI)- , matchAny- "UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS"- AcceptFailure- (folding (concatOf dsrsStacks) .- sStackStatus . to toTextCI)- , matchAny "UPDATE_ROLLBACK_FAILED" AcceptFailure (folding (concatOf dsrsStacks) .@@ -212,4 +144,22 @@ AcceptFailure (folding (concatOf dsrsStacks) . sStackStatus . to toTextCI)]+ }++-- | Polls 'Network.AWS.CloudFormation.DescribeChangeSet' every 30 seconds until a successful state is reached. An error is returned after 120 failed checks.+changeSetCreateComplete :: Wait DescribeChangeSet+changeSetCreateComplete =+ Wait+ { _waitName = "ChangeSetCreateComplete"+ , _waitAttempts = 120+ , _waitDelay = 30+ , _waitAcceptors = [ matchAll+ "CREATE_COMPLETE"+ AcceptSuccess+ (drsStatus . to toTextCI)+ , matchAll+ "FAILED"+ AcceptFailure+ (drsStatus . to toTextCI)+ , matchError "ValidationError" AcceptFailure] }
test/Test/AWS/Gen/CloudFormation.hs view
@@ -73,6 +73,9 @@ -- , requestSetStackPolicy $ -- setStackPolicy --+-- , requestListImports $+-- listImports+-- -- , requestListStacks $ -- listStacks --@@ -91,6 +94,9 @@ -- , requestDeleteChangeSet $ -- deleteChangeSet --+-- , requestListExports $+-- listExports+-- -- , requestGetTemplate $ -- getTemplate --@@ -148,6 +154,9 @@ -- , responseSetStackPolicy $ -- setStackPolicyResponse --+-- , responseListImports $+-- listImportsResponse+-- -- , responseListStacks $ -- listStacksResponse --@@ -166,6 +175,9 @@ -- , responseDeleteChangeSet $ -- deleteChangeSetResponse --+-- , responseListExports $+-- listExportsResponse+-- -- , responseGetTemplate $ -- getTemplateResponse --@@ -255,6 +267,11 @@ "SetStackPolicy" "fixture/SetStackPolicy.yaml" +requestListImports :: ListImports -> TestTree+requestListImports = req+ "ListImports"+ "fixture/ListImports.yaml"+ requestListStacks :: ListStacks -> TestTree requestListStacks = req "ListStacks"@@ -285,6 +302,11 @@ "DeleteChangeSet" "fixture/DeleteChangeSet.yaml" +requestListExports :: ListExports -> TestTree+requestListExports = req+ "ListExports"+ "fixture/ListExports.yaml"+ requestGetTemplate :: GetTemplate -> TestTree requestGetTemplate = req "GetTemplate"@@ -407,6 +429,13 @@ cloudFormation (Proxy :: Proxy SetStackPolicy) +responseListImports :: ListImportsResponse -> TestTree+responseListImports = res+ "ListImportsResponse"+ "fixture/ListImportsResponse.proto"+ cloudFormation+ (Proxy :: Proxy ListImports)+ responseListStacks :: ListStacksResponse -> TestTree responseListStacks = res "ListStacksResponse"@@ -448,6 +477,13 @@ "fixture/DeleteChangeSetResponse.proto" cloudFormation (Proxy :: Proxy DeleteChangeSet)++responseListExports :: ListExportsResponse -> TestTree+responseListExports = res+ "ListExportsResponse"+ "fixture/ListExportsResponse.proto"+ cloudFormation+ (Proxy :: Proxy ListExports) responseGetTemplate :: GetTemplateResponse -> TestTree responseGetTemplate = res