amazonka-cloudformation 0.0.1 → 0.0.2
raw patch · 21 files changed
+448/−394 lines, 21 filesdep ~amazonka-corePVP ok
version bump matches the API change (PVP)
Dependency ranges changed: amazonka-core
API changes (from Hackage documentation)
Files
- README.md +11/−1
- amazonka-cloudformation.cabal +13/−14
- gen/Network/AWS/CloudFormation.hs +9/−9
- gen/Network/AWS/CloudFormation/CancelUpdateStack.hs +5/−4
- gen/Network/AWS/CloudFormation/CreateStack.hs +48/−46
- gen/Network/AWS/CloudFormation/DeleteStack.hs +1/−1
- gen/Network/AWS/CloudFormation/DescribeStackEvents.hs +17/−14
- gen/Network/AWS/CloudFormation/DescribeStackResource.hs +15/−11
- gen/Network/AWS/CloudFormation/DescribeStackResources.hs +37/−30
- gen/Network/AWS/CloudFormation/DescribeStacks.hs +8/−8
- gen/Network/AWS/CloudFormation/EstimateTemplateCost.hs +16/−14
- gen/Network/AWS/CloudFormation/GetStackPolicy.hs +3/−5
- gen/Network/AWS/CloudFormation/GetTemplate.hs +14/−10
- gen/Network/AWS/CloudFormation/GetTemplateSummary.hs +35/−30
- gen/Network/AWS/CloudFormation/ListStackResources.hs +14/−9
- gen/Network/AWS/CloudFormation/ListStacks.hs +14/−15
- gen/Network/AWS/CloudFormation/SetStackPolicy.hs +4/−5
- gen/Network/AWS/CloudFormation/SignalResource.hs +10/−10
- gen/Network/AWS/CloudFormation/Types.hs +92/−81
- gen/Network/AWS/CloudFormation/UpdateStack.hs +65/−62
- gen/Network/AWS/CloudFormation/ValidateTemplate.hs +17/−15
README.md view
@@ -8,7 +8,17 @@ ## Description -AWS CloudFormation gives developers and systems administrators an easy way to create and manage a collection of related AWS resources, provisioning and updating them in an orderly and predictable fashion. You can use AWS CloudFormation’s sample templates or create your own templates to describe the AWS resources, and any associated dependencies or runtime parameters, required to run your application. You don’t need to figure out the order for provisioning AWS services or the subtleties of making those dependencies work. CloudFormation takes care of this for you. After the AWS resources are deployed, you can modify and update them in a controlled and predictable way, in effect applying version control to your AWS infrastructure the same way you do with your software.+ AWS CloudFormation gives developers and systems administrators an easy way to+ create and manage a collection of related AWS resources, provisioning and+ updating them in an orderly and predictable fashion. You can use AWS+ CloudFormation’s sample templates or create your own templates to describe+ the AWS resources, and any associated dependencies or runtime parameters,+ required to run your application. You don’t need to figure out the order for+ provisioning AWS services or the subtleties of making those dependencies+ work. CloudFormation takes care of this for you. After the AWS resources are+ deployed, you can modify and update them in a controlled and predictable way,+ in effect applying version control to your AWS infrastructure the same way+ you do with your software. Documentation is available via [Hackage](http://hackage.haskell.org/package/amazonka-cloudformation) and [AWS API Reference](http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html).
amazonka-cloudformation.cabal view
@@ -1,5 +1,5 @@ name: amazonka-cloudformation-version: 0.0.1+version: 0.0.2 synopsis: Amazon CloudFormation SDK. homepage: https://github.com/brendanhay/amazonka license: OtherLicense@@ -13,18 +13,17 @@ cabal-version: >= 1.10 description:- AWS CloudFormation gives developers and systems administrators an easy- way to create and manage a collection of related AWS resources,- provisioning and updating them in an orderly and predictable fashion.- You can use AWS CloudFormation’s sample templates or create your own- templates to describe the AWS resources, and any associated- dependencies or runtime parameters, required to run your application.- You don’t need to figure out the order for provisioning AWS services or- the subtleties of making those dependencies work. CloudFormation takes- care of this for you. After the AWS resources are deployed, you can- modify and update them in a controlled and predictable way, in effect- applying version control to your AWS infrastructure the same way you do- with your software.+ AWS CloudFormation gives developers and systems administrators an easy way to+ create and manage a collection of related AWS resources, provisioning and+ updating them in an orderly and predictable fashion. You can use AWS+ CloudFormation’s sample templates or create your own templates to describe+ the AWS resources, and any associated dependencies or runtime parameters,+ required to run your application. You don’t need to figure out the order for+ provisioning AWS services or the subtleties of making those dependencies+ work. CloudFormation takes care of this for you. After the AWS resources are+ deployed, you can modify and update them in a controlled and predictable way,+ in effect applying version control to your AWS infrastructure the same way+ you do with your software. . /See:/ <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html AWS API Reference> .@@ -65,5 +64,5 @@ other-modules: build-depends:- amazonka-core == 0.0.1.*+ amazonka-core == 0.0.2.* , base >= 4.7 && < 5
gen/Network/AWS/CloudFormation.hs view
@@ -8,17 +8,17 @@ -- Stability : experimental -- Portability : non-portable (GHC extensions) --- | AWS CloudFormation gives developers and systems administrators an easy way--- to create and manage a collection of related AWS resources, provisioning--- and updating them in an orderly and predictable fashion. You can use AWS+-- | AWS CloudFormation gives developers and systems administrators an easy way to+-- create and manage a collection of related AWS resources, provisioning and+-- updating them in an orderly and predictable fashion. You can use AWS -- CloudFormation’s sample templates or create your own templates to describe -- the AWS resources, and any associated dependencies or runtime parameters,--- required to run your application. You don’t need to figure out the order--- for provisioning AWS services or the subtleties of making those--- dependencies work. CloudFormation takes care of this for you. After the AWS--- resources are deployed, you can modify and update them in a controlled and--- predictable way, in effect applying version control to your AWS--- infrastructure the same way you do with your software.+-- required to run your application. You don’t need to figure out the order for+-- provisioning AWS services or the subtleties of making those dependencies+-- work. CloudFormation takes care of this for you. After the AWS resources are+-- deployed, you can modify and update them in a controlled and predictable way,+-- in effect applying version control to your AWS infrastructure the same way+-- you do with your software. module Network.AWS.CloudFormation ( module Network.AWS.CloudFormation.CancelUpdateStack , module Network.AWS.CloudFormation.CreateStack
gen/Network/AWS/CloudFormation/CancelUpdateStack.hs view
@@ -20,10 +20,11 @@ -- Stability : experimental -- Portability : non-portable (GHC extensions) --- | Cancels an update on the specified stack. If the call completes--- successfully, the stack will roll back the update and revert to the--- previous stack configuration. Only stacks that are in the--- UPDATE_IN_PROGRESS state can be canceled.+-- | Cancels an update on the specified stack. If the call completes successfully,+-- the stack will roll back the update and revert to the previous stack+-- configuration.+--+-- Only stacks that are in the UPDATE_IN_PROGRESS state can be canceled. -- -- <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CancelUpdateStack.html> module Network.AWS.CloudFormation.CancelUpdateStack
gen/Network/AWS/CloudFormation/CreateStack.hs view
@@ -22,7 +22,7 @@ -- | 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.+-- stack via the 'DescribeStacks' API. -- -- <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateStack.html> module Network.AWS.CloudFormation.CreateStack@@ -118,95 +118,97 @@ , _csTags = mempty } --- | A list of capabilities that you must specify before AWS CloudFormation--- can create or update certain stacks. Some stack templates might include--- resources that can affect permissions in your AWS account. For those--- stacks, you must explicitly acknowledge their capabilities by specifying--- this parameter. Currently, the only valid value is CAPABILITY_IAM, which--- is required for the following resources: AWS::CloudFormation::Stack,--- AWS::IAM::AccessKey, AWS::IAM::Group, AWS::IAM::InstanceProfile,--- AWS::IAM::Policy, AWS::IAM::Role, AWS::IAM::User, and--- AWS::IAM::UserToGroupAddition. If your stack template contains these--- resources, we recommend that you review any permissions associated with--- them. If you don't specify this parameter, this action returns an--- InsufficientCapabilities error.+-- | A list of capabilities that you must specify before AWS CloudFormation can+-- create or update certain stacks. Some stack templates might include resources+-- that can affect permissions in your AWS account. For those stacks, you must+-- explicitly acknowledge their capabilities by specifying this parameter.+--+-- Currently, the only valid value is 'CAPABILITY_IAM', which is required for the+-- following resources: <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html AWS::CloudFormation::Stack>, <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 any+-- permissions associated with them. If you don't specify this parameter, this+-- action returns an 'InsufficientCapabilities' error. csCapabilities :: Lens' CreateStack [Capability] csCapabilities = lens _csCapabilities (\s a -> s { _csCapabilities = a }) . _List --- | 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 }) -- | The Simple Notification Service (SNS) topic ARNs to publish stack related--- events. You can find your SNS topic ARNs using the SNS console or your+-- events. You can find your SNS topic ARNs using the <http://console.aws.amazon.com/sns SNS console> or your -- Command Line Interface (CLI). csNotificationARNs :: Lens' CreateStack [Text] csNotificationARNs = lens _csNotificationARNs (\s a -> s { _csNotificationARNs = a }) . _List --- | 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 }) --- | A list of Parameter structures that specify input parameters for the--- stack.+-- | A list of 'Parameter' structures that specify input parameters for the stack. csParameters :: Lens' CreateStack [Parameter] csParameters = lens _csParameters (\s a -> s { _csParameters = a }) . _List --- | The name associated with the stack. The name must be unique within your--- AWS account. Must contain only alphanumeric characters (case sensitive)--- and start with an alpha character. Maximum length of the name is 255--- characters.+-- | The name associated with the stack. The name must be unique within your AWS+-- account.+--+-- Must contain only alphanumeric characters (case sensitive) and start with an+-- alpha character. Maximum length of the name is 255 characters. csStackName :: Lens' CreateStack Text csStackName = lens _csStackName (\s a -> s { _csStackName = a }) --- | Structure containing the stack policy body. For more information, go to--- 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 }) -- | 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+-- 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 }) --- | A set of user-defined Tags to associate with this stack, represented by--- key/value pairs. Tags defined for the stack are propagated to EC2--- resources that are created as part of the stack. A maximum number of 10--- tags can be specified.+-- | A set of user-defined 'Tags' to associate with this stack, represented by+-- key/value pairs. Tags defined for the stack are propagated to EC2 resources+-- that are created as part of the stack. A maximum number of 10 tags can be+-- specified. csTags :: Lens' CreateStack [Tag] csTags = lens _csTags (\s a -> s { _csTags = a }) . _List --- | 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--- 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: 307,200 bytes) located in an S3 bucket in the same--- region as the stack. For more information, go to the Template Anatomy in--- the AWS CloudFormation User Guide. Conditional: You must specify either--- the TemplateBody or the TemplateURL parameter, but not both.+-- template (max size: 307,200 bytes) located in an S3 bucket in the same region+-- as the stack. 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 }) -- | 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.+-- 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 })
gen/Network/AWS/CloudFormation/DeleteStack.hs view
@@ -21,7 +21,7 @@ -- 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+-- deletion starts. Deleted stacks do not show up in the 'DescribeStacks' API if -- the deletion has been completed successfully. -- -- <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DeleteStack.html>
gen/Network/AWS/CloudFormation/DescribeStackEvents.hs view
@@ -20,12 +20,13 @@ -- Stability : experimental -- Portability : non-portable (GHC extensions) --- | Returns all stack related events for a specified stack. For more--- information about a stack's event history, go to 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).+-- | Returns all stack related events for a specified stack. 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).+-- -- <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeStackEvents.html> module Network.AWS.CloudFormation.DescribeStackEvents (@@ -70,15 +71,18 @@ , _dseNextToken = Nothing } --- | String that identifies the start of the next list of events, if there is--- one. Default: There is no default value.+-- | String that identifies the start of the next list of events, if there is one.+--+-- Default: There is no default value. dseNextToken :: Lens' DescribeStackEvents (Maybe Text) dseNextToken = lens _dseNextToken (\s a -> s { _dseNextToken = a }) --- | The name or the unique identifier 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 identifier 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 }) @@ -101,12 +105,11 @@ , _dserNextToken = Nothing } --- | String that identifies the start of the next list of events, if there is--- one.+-- | String that identifies the start of the next list of events, if there is one. dserNextToken :: Lens' DescribeStackEventsResponse (Maybe Text) dserNextToken = lens _dserNextToken (\s a -> s { _dserNextToken = a }) --- | A list of StackEvents structures.+-- | A list of 'StackEvents' structures. dserStackEvents :: Lens' DescribeStackEventsResponse [StackEvent] dserStackEvents = lens _dserStackEvents (\s a -> s { _dserStackEvents = a }) . _List
gen/Network/AWS/CloudFormation/DescribeStackResource.hs view
@@ -20,10 +20,11 @@ -- Stability : experimental -- Portability : non-portable (GHC extensions) --- | 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.+-- | 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.+-- -- <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeStackResource.html> module Network.AWS.CloudFormation.DescribeStackResource (@@ -69,16 +70,19 @@ , _dsr1LogicalResourceId = p2 } --- | 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. dsr1LogicalResourceId :: Lens' DescribeStackResource Text dsr1LogicalResourceId = lens _dsr1LogicalResourceId (\s a -> s { _dsr1LogicalResourceId = a }) --- | The name or the unique identifier 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 identifier 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. dsr1StackName :: Lens' DescribeStackResource Text dsr1StackName = lens _dsr1StackName (\s a -> s { _dsr1StackName = a }) @@ -97,8 +101,8 @@ { _dsrrStackResourceDetail = Nothing } --- | 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. dsrrStackResourceDetail :: Lens' DescribeStackResourceResponse (Maybe StackResourceDetail) dsrrStackResourceDetail = lens _dsrrStackResourceDetail (\s a -> s { _dsrrStackResourceDetail = a })
gen/Network/AWS/CloudFormation/DescribeStackResources.hs view
@@ -20,20 +20,22 @@ -- Stability : experimental -- 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. 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. 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 AWS--- CloudFormation User Guide. A ValidationError is returned if you specify--- both StackName and PhysicalResourceId in the same request.+-- | 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.+--+-- 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.+-- -- <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeStackResources.html> module Network.AWS.CloudFormation.DescribeStackResources (@@ -82,30 +84,35 @@ , _dsrPhysicalResourceId = 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 identifier 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 identifier 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 }) @@ -130,7 +137,7 @@ { _dsrrStackResources = mempty } --- | A list of StackResource structures.+-- | A list of 'StackResource' structures. dsrrStackResources :: Lens' DescribeStackResourcesResponse [StackResource] dsrrStackResources = lens _dsrrStackResources (\s a -> s { _dsrrStackResources = a })
gen/Network/AWS/CloudFormation/DescribeStacks.hs view
@@ -67,15 +67,16 @@ , _ds1NextToken = Nothing } --- | String that identifies the start of the next list of stacks, if there is--- one.+-- | String that identifies the start of the next list of stacks, if there is one. ds1NextToken :: Lens' DescribeStacks (Maybe Text) ds1NextToken = lens _ds1NextToken (\s a -> s { _ds1NextToken = a }) --- | The name or the unique identifier 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 identifier 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. ds1StackName :: Lens' DescribeStacks (Maybe Text) ds1StackName = lens _ds1StackName (\s a -> s { _ds1StackName = a }) @@ -98,8 +99,7 @@ , _dsrNextToken = Nothing } --- | String that identifies the start of the next list of stacks, if there is--- one.+-- | String that identifies the start of the next list of stacks, if there is one. dsrNextToken :: Lens' DescribeStacksResponse (Maybe Text) dsrNextToken = lens _dsrNextToken (\s a -> s { _dsrNextToken = a })
gen/Network/AWS/CloudFormation/EstimateTemplateCost.hs view
@@ -20,8 +20,8 @@ -- Stability : experimental -- 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+-- | 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. -- -- <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_EstimateTemplateCost.html>@@ -72,23 +72,25 @@ , _etcParameters = mempty } --- | 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 }) . _List --- | 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--- 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 located in an S3 bucket in the same region as the stack. For--- more information, go to Template Anatomy in the AWS CloudFormation User--- Guide. Conditional: You must pass TemplateURL or TemplateBody. If both--- are passed, only TemplateBody is used.+-- template located in an S3 bucket in the same region as the stack. 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 }) @@ -107,8 +109,8 @@ { _etcrUrl = Nothing } --- | An AWS Simple Monthly Calculator URL with a query string that describes--- the resources required to run the template.+-- | An AWS Simple Monthly Calculator URL with a query string that describes the+-- resources required to run the template. etcrUrl :: Lens' EstimateTemplateCostResponse (Maybe Text) etcrUrl = lens _etcrUrl (\s a -> s { _etcrUrl = a })
gen/Network/AWS/CloudFormation/GetStackPolicy.hs view
@@ -62,8 +62,8 @@ { _gspStackName = p1 } --- | The name or stack ID that is associated with the stack whose policy you--- want to get.+-- | The name or stack ID that is associated with the stack whose policy you want+-- to get. gspStackName :: Lens' GetStackPolicy Text gspStackName = lens _gspStackName (\s a -> s { _gspStackName = a }) @@ -82,9 +82,7 @@ { _gsprStackPolicyBody = Nothing } --- | Structure containing the stack policy body. (For more information, go to--- Prevent Updates to Stack Resources in the AWS CloudFormation User--- Guide.).+-- | 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.) gsprStackPolicyBody :: Lens' GetStackPolicyResponse (Maybe Text) gsprStackPolicyBody = lens _gsprStackPolicyBody (\s a -> s { _gsprStackPolicyBody = a })
gen/Network/AWS/CloudFormation/GetTemplate.hs view
@@ -20,11 +20,14 @@ -- Stability : experimental -- Portability : non-portable (GHC extensions) --- | 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.+-- | 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.+-- -- <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_GetTemplate.html> module Network.AWS.CloudFormation.GetTemplate (@@ -64,10 +67,12 @@ { _gtStackName = p1 } --- | The name or the unique identifier 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 identifier 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 gtStackName = lens _gtStackName (\s a -> s { _gtStackName = a }) @@ -86,8 +91,7 @@ { _gtrTemplateBody = Nothing } --- | Structure containing the template body. (For more information, go to--- Template Anatomy in the AWS CloudFormation User Guide.).+-- | Structure containing the template body. (For more information, go to <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html TemplateAnatomy> in the AWS CloudFormation User Guide.) gtrTemplateBody :: Lens' GetTemplateResponse (Maybe Text) gtrTemplateBody = lens _gtrTemplateBody (\s a -> s { _gtrTemplateBody = a })
gen/Network/AWS/CloudFormation/GetTemplateSummary.hs view
@@ -20,15 +20,17 @@ -- Stability : experimental -- 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. 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.+-- | 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.+-- -- <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_GetTemplateSummary.html> module Network.AWS.CloudFormation.GetTemplateSummary (@@ -81,27 +83,31 @@ , _gtsStackName = Nothing } --- | The name or the unique identifier 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 unique identifier 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 }) --- | 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 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: 307,200 bytes) located in an Amazon S3 bucket. For--- more information about templates, see Template Anatomy in the AWS--- CloudFormation User Guide. Conditional: You must specify only one of the--- following parameters: StackName, TemplateBody, or TemplateURL.+-- template (max size: 307,200 bytes) 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 }) @@ -137,11 +143,10 @@ } -- | The capabilities found within the template. Currently, AWS CloudFormation--- supports only the CAPABILITY_IAM capability. If your template contains--- IAM resources, you must specify the CAPABILITY_IAM value for this--- parameter when you use the CreateStack or UpdateStack actions with your--- template; otherwise, those actions return an InsufficientCapabilities--- error.+-- supports only the CAPABILITY_IAM capability. If your template contains IAM+-- resources, you must specify the CAPABILITY_IAM value for this parameter when+-- you use the 'CreateStack' or 'UpdateStack' actions with your template; otherwise,+-- those actions return an InsufficientCapabilities error. gtsrCapabilities :: Lens' GetTemplateSummaryResponse [Capability] gtsrCapabilities = lens _gtsrCapabilities (\s a -> s { _gtsrCapabilities = a }) . _List @@ -150,12 +155,12 @@ gtsrCapabilitiesReason = lens _gtsrCapabilitiesReason (\s a -> s { _gtsrCapabilitiesReason = 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. gtsrDescription :: Lens' GetTemplateSummaryResponse (Maybe Text) gtsrDescription = lens _gtsrDescription (\s a -> s { _gtsrDescription = a }) --- | A list of parameter declarations that describe various properties for--- each parameter.+-- | A list of parameter declarations that describe various properties for each+-- parameter. gtsrParameters :: Lens' GetTemplateSummaryResponse [ParameterDeclaration] gtsrParameters = lens _gtsrParameters (\s a -> s { _gtsrParameters = a }) . _List
gen/Network/AWS/CloudFormation/ListStackResources.hs view
@@ -20,10 +20,11 @@ -- Stability : experimental -- Portability : non-portable (GHC extensions) --- | 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.+-- | 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.+-- -- <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ListStackResources.html> module Network.AWS.CloudFormation.ListStackResources (@@ -70,14 +71,18 @@ } -- | String that identifies the start of the next list of stack resource--- summaries, if there is one. Default: There is no default value.+-- summaries, if there is one.+--+-- Default: There is no default value. lsrNextToken :: Lens' ListStackResources (Maybe Text) lsrNextToken = lens _lsrNextToken (\s a -> s { _lsrNextToken = a }) --- | The name or the unique identifier 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 identifier 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 }) @@ -105,7 +110,7 @@ lsrrNextToken :: Lens' ListStackResourcesResponse (Maybe Text) lsrrNextToken = lens _lsrrNextToken (\s a -> s { _lsrrNextToken = a }) --- | A list of StackResourceSummary structures.+-- | A list of 'StackResourceSummary' structures. lsrrStackResourceSummaries :: Lens' ListStackResourcesResponse [StackResourceSummary] lsrrStackResourceSummaries = lens _lsrrStackResourceSummaries
gen/Network/AWS/CloudFormation/ListStacks.hs view
@@ -20,11 +20,11 @@ -- Stability : experimental -- Portability : non-portable (GHC extensions) --- | 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).+-- | 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). -- -- <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ListStacks.html> module Network.AWS.CloudFormation.ListStacks@@ -70,15 +70,15 @@ , _lsStackStatusFilter = mempty } --- | String that identifies the start of the next list of stacks, if there is--- one. Default: There is no default value.+-- | String that identifies the start of the next list of stacks, if there is one.+--+-- Default: There is no default value. 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 })@@ -103,13 +103,12 @@ , _lsr1NextToken = Nothing } --- | String that identifies the start of the next list of stacks, if there is--- one.+-- | String that identifies the start of the next list of stacks, if there is one. lsr1NextToken :: Lens' ListStacksResponse (Maybe Text) lsr1NextToken = lens _lsr1NextToken (\s a -> s { _lsr1NextToken = a }) --- | A list of StackSummary structures containing information about the--- specified stacks.+-- | A list of 'StackSummary' structures containing information about the specified+-- stacks. lsr1StackSummaries :: Lens' ListStacksResponse [StackSummary] lsr1StackSummaries = lens _lsr1StackSummaries (\s a -> s { _lsr1StackSummaries = a })
gen/Network/AWS/CloudFormation/SetStackPolicy.hs view
@@ -73,17 +73,16 @@ sspStackName :: Lens' SetStackPolicy Text sspStackName = lens _sspStackName (\s a -> s { _sspStackName = a }) --- | Structure containing the stack policy body. For more information, go to--- 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 (max size: 16KB) located in an S3 bucket in the same region as the--- stack. You can specify either the StackPolicyBody or the StackPolicyURL+-- stack. You can specify either the 'StackPolicyBody' or the 'StackPolicyURL' -- parameter, but not both. sspStackPolicyURL :: Lens' SetStackPolicy (Maybe Text) sspStackPolicyURL =
gen/Network/AWS/CloudFormation/SignalResource.hs view
@@ -23,9 +23,9 @@ -- | 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.+-- 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. -- -- <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SignalResource.html> module Network.AWS.CloudFormation.SignalResource@@ -82,8 +82,8 @@ , _srStatus = p4 } --- | 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.+-- | 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. srLogicalResourceId :: Lens' SignalResource Text srLogicalResourceId = lens _srLogicalResourceId (\s a -> s { _srLogicalResourceId = a })@@ -93,15 +93,15 @@ srStackName = lens _srStackName (\s a -> s { _srStackName = a }) -- | 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.+-- signal causes AWS CloudFormation to immediately fail the stack creation or+-- update. srStatus :: Lens' SignalResource ResourceSignalStatus srStatus = lens _srStatus (\s a -> s { _srStatus = a }) -- | 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.+-- 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. srUniqueId :: Lens' SignalResource Text srUniqueId = lens _srUniqueId (\s a -> s { _srUniqueId = a })
gen/Network/AWS/CloudFormation/Types.hs view
@@ -208,13 +208,13 @@ , _tagValue = Nothing } --- | 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 }) --- | Required. A string containing the value for this tag. You can specify a+-- | /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 })@@ -252,22 +252,25 @@ instance Hashable StackStatus instance FromText StackStatus where- parser = match "CREATE_COMPLETE" CreateComplete- <|> match "CREATE_FAILED" CreateFailed- <|> match "CREATE_IN_PROGRESS" CreateInProgress- <|> match "DELETE_COMPLETE" DeleteComplete- <|> match "DELETE_FAILED" DeleteFailed- <|> match "DELETE_IN_PROGRESS" DeleteInProgress- <|> match "ROLLBACK_COMPLETE" RollbackComplete- <|> match "ROLLBACK_FAILED" RollbackFailed- <|> match "ROLLBACK_IN_PROGRESS" RollbackInProgress- <|> match "UPDATE_COMPLETE" UpdateComplete- <|> match "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS" UpdateCompleteCleanupInProgress- <|> match "UPDATE_IN_PROGRESS" UpdateInProgress- <|> match "UPDATE_ROLLBACK_COMPLETE" UpdateRollbackComplete- <|> match "UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS" UpdateRollbackCompleteCleanupInProgress- <|> match "UPDATE_ROLLBACK_FAILED" UpdateRollbackFailed- <|> match "UPDATE_ROLLBACK_IN_PROGRESS" UpdateRollbackInProgress+ parser = takeText >>= \case+ "CREATE_COMPLETE" -> pure CreateComplete+ "CREATE_FAILED" -> pure CreateFailed+ "CREATE_IN_PROGRESS" -> pure CreateInProgress+ "DELETE_COMPLETE" -> pure DeleteComplete+ "DELETE_FAILED" -> pure DeleteFailed+ "DELETE_IN_PROGRESS" -> pure DeleteInProgress+ "ROLLBACK_COMPLETE" -> pure RollbackComplete+ "ROLLBACK_FAILED" -> pure RollbackFailed+ "ROLLBACK_IN_PROGRESS" -> pure RollbackInProgress+ "UPDATE_COMPLETE" -> pure UpdateComplete+ "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS" -> pure UpdateCompleteCleanupInProgress+ "UPDATE_IN_PROGRESS" -> pure UpdateInProgress+ "UPDATE_ROLLBACK_COMPLETE" -> pure UpdateRollbackComplete+ "UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS" -> pure UpdateRollbackCompleteCleanupInProgress+ "UPDATE_ROLLBACK_FAILED" -> pure UpdateRollbackFailed+ "UPDATE_ROLLBACK_IN_PROGRESS" -> pure UpdateRollbackInProgress+ e -> fail $+ "Failure parsing StackStatus from " ++ show e instance ToText StackStatus where toText = \case@@ -295,7 +298,6 @@ instance FromXML StackStatus where parseXML = parseXMLText "StackStatus" - data StackEvent = StackEvent { _seEventId :: Text , _seLogicalResourceId :: Maybe Text@@ -306,7 +308,7 @@ , _seResourceType :: Maybe Text , _seStackId :: Text , _seStackName :: Text- , _seTimestamp :: RFC822+ , _seTimestamp :: ISO8601 } deriving (Eq, Show) -- | 'StackEvent' constructor.@@ -360,8 +362,8 @@ seLogicalResourceId = lens _seLogicalResourceId (\s a -> s { _seLogicalResourceId = a }) --- | The name or unique identifier associated with the physical instance of--- the resource.+-- | The name or unique identifier associated with the physical instance of the+-- resource. sePhysicalResourceId :: Lens' StackEvent (Maybe Text) sePhysicalResourceId = lens _sePhysicalResourceId (\s a -> s { _sePhysicalResourceId = a })@@ -380,8 +382,8 @@ seResourceStatusReason = lens _seResourceStatusReason (\s a -> s { _seResourceStatusReason = a }) --- | Type of resource. (For more information, go to AWS Resource Types--- Reference in the AWS CloudFormation User Guide.).+-- | 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.) seResourceType :: Lens' StackEvent (Maybe Text) seResourceType = lens _seResourceType (\s a -> s { _seResourceType = a }) @@ -425,9 +427,9 @@ ] data StackSummary = StackSummary- { _ssCreationTime :: RFC822- , _ssDeletionTime :: Maybe RFC822- , _ssLastUpdatedTime :: Maybe RFC822+ { _ssCreationTime :: ISO8601+ , _ssDeletionTime :: Maybe ISO8601+ , _ssLastUpdatedTime :: Maybe ISO8601 , _ssStackId :: Maybe Text , _ssStackName :: Text , _ssStackStatus :: StackStatus@@ -478,8 +480,8 @@ ssDeletionTime :: Lens' StackSummary (Maybe UTCTime) ssDeletionTime = lens _ssDeletionTime (\s a -> s { _ssDeletionTime = a }) . mapping _Time --- | The time the stack was last updated. This field will only be returned if--- the stack has been updated at least once.+-- | The time the stack was last updated. This field will only be returned if the+-- stack has been updated at least once. ssLastUpdatedTime :: Lens' StackSummary (Maybe UTCTime) ssLastUpdatedTime = lens _ssLastUpdatedTime (\s a -> s { _ssLastUpdatedTime = a })@@ -532,7 +534,7 @@ data StackResourceDetail = StackResourceDetail { _srdDescription :: Maybe Text- , _srdLastUpdatedTimestamp :: RFC822+ , _srdLastUpdatedTimestamp :: ISO8601 , _srdLogicalResourceId :: Text , _srdMetadata :: Maybe Text , _srdPhysicalResourceId :: Maybe Text@@ -600,14 +602,14 @@ srdLogicalResourceId = lens _srdLogicalResourceId (\s a -> s { _srdLogicalResourceId = a }) --- | The JSON format content of the Metadata attribute declared for the--- resource. For more information, see Metadata Attribute in the AWS--- CloudFormation User Guide.+-- | 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. srdMetadata :: Lens' StackResourceDetail (Maybe Text) srdMetadata = lens _srdMetadata (\s a -> s { _srdMetadata = a }) --- | The name or unique identifier that corresponds to a physical instance ID--- of a resource supported by AWS CloudFormation.+-- | The name or unique identifier that corresponds to a physical instance ID of a+-- resource supported by AWS CloudFormation. srdPhysicalResourceId :: Lens' StackResourceDetail (Maybe Text) srdPhysicalResourceId = lens _srdPhysicalResourceId (\s a -> s { _srdPhysicalResourceId = a })@@ -622,8 +624,8 @@ srdResourceStatusReason = lens _srdResourceStatusReason (\s a -> s { _srdResourceStatusReason = a }) --- | Type of resource. ((For more information, go to AWS Resource Types--- Reference in the AWS CloudFormation User Guide.).+-- | 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.) srdResourceType :: Lens' StackResourceDetail Text srdResourceType = lens _srdResourceType (\s a -> s { _srdResourceType = a }) @@ -678,16 +680,19 @@ instance Hashable ResourceStatus instance FromText ResourceStatus where- parser = match "CREATE_COMPLETE" RSCreateComplete- <|> match "CREATE_FAILED" RSCreateFailed- <|> match "CREATE_IN_PROGRESS" RSCreateInProgress- <|> match "DELETE_COMPLETE" RSDeleteComplete- <|> match "DELETE_FAILED" RSDeleteFailed- <|> match "DELETE_IN_PROGRESS" RSDeleteInProgress- <|> match "DELETE_SKIPPED" RSDeleteSkipped- <|> match "UPDATE_COMPLETE" RSUpdateComplete- <|> match "UPDATE_FAILED" RSUpdateFailed- <|> match "UPDATE_IN_PROGRESS" RSUpdateInProgress+ parser = takeText >>= \case+ "CREATE_COMPLETE" -> pure RSCreateComplete+ "CREATE_FAILED" -> pure RSCreateFailed+ "CREATE_IN_PROGRESS" -> pure RSCreateInProgress+ "DELETE_COMPLETE" -> pure RSDeleteComplete+ "DELETE_FAILED" -> pure RSDeleteFailed+ "DELETE_IN_PROGRESS" -> pure RSDeleteInProgress+ "DELETE_SKIPPED" -> pure RSDeleteSkipped+ "UPDATE_COMPLETE" -> pure RSUpdateComplete+ "UPDATE_FAILED" -> pure RSUpdateFailed+ "UPDATE_IN_PROGRESS" -> pure RSUpdateInProgress+ e -> fail $+ "Failure parsing ResourceStatus from " ++ show e instance ToText ResourceStatus where toText = \case@@ -709,7 +714,6 @@ instance FromXML ResourceStatus where parseXML = parseXMLText "ResourceStatus" - data TemplateParameter = TemplateParameter { _tpDefaultValue :: Maybe Text , _tpDescription :: Maybe Text@@ -745,8 +749,8 @@ tpDescription :: Lens' TemplateParameter (Maybe Text) tpDescription = lens _tpDescription (\s a -> s { _tpDescription = a }) --- | Flag indicating whether the parameter should be displayed as plain text--- in logs and UIs.+-- | Flag indicating whether the parameter should be displayed as plain text in+-- logs and UIs. tpNoEcho :: Lens' TemplateParameter (Maybe Bool) tpNoEcho = lens _tpNoEcho (\s a -> s { _tpNoEcho = a }) @@ -847,7 +851,7 @@ , _sr1ResourceType :: Text , _sr1StackId :: Maybe Text , _sr1StackName :: Maybe Text- , _sr1Timestamp :: RFC822+ , _sr1Timestamp :: ISO8601 } deriving (Eq, Show) -- | 'StackResource' constructor.@@ -898,8 +902,8 @@ sr1LogicalResourceId = lens _sr1LogicalResourceId (\s a -> s { _sr1LogicalResourceId = a }) --- | The name or unique identifier that corresponds to a physical instance ID--- of a resource supported by AWS CloudFormation.+-- | The name or unique identifier that corresponds to a physical instance ID of a+-- resource supported by AWS CloudFormation. sr1PhysicalResourceId :: Lens' StackResource (Maybe Text) sr1PhysicalResourceId = lens _sr1PhysicalResourceId (\s a -> s { _sr1PhysicalResourceId = a })@@ -914,8 +918,8 @@ sr1ResourceStatusReason = lens _sr1ResourceStatusReason (\s a -> s { _sr1ResourceStatusReason = a }) --- | Type of resource. (For more information, go to AWS Resource Types--- Reference in the AWS CloudFormation User Guide.).+-- | 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.) sr1ResourceType :: Lens' StackResource Text sr1ResourceType = lens _sr1ResourceType (\s a -> s { _sr1ResourceType = a }) @@ -1005,7 +1009,7 @@ ] data StackResourceSummary = StackResourceSummary- { _srsLastUpdatedTimestamp :: RFC822+ { _srsLastUpdatedTimestamp :: ISO8601 , _srsLogicalResourceId :: Text , _srsPhysicalResourceId :: Maybe Text , _srsResourceStatus :: ResourceStatus@@ -1054,8 +1058,8 @@ srsLogicalResourceId = lens _srsLogicalResourceId (\s a -> s { _srsLogicalResourceId = a }) --- | The name or unique identifier that corresponds to a physical instance ID--- of the resource.+-- | The name or unique identifier that corresponds to a physical instance ID of+-- the resource. srsPhysicalResourceId :: Lens' StackResourceSummary (Maybe Text) srsPhysicalResourceId = lens _srsPhysicalResourceId (\s a -> s { _srsPhysicalResourceId = a })@@ -1070,8 +1074,8 @@ srsResourceStatusReason = lens _srsResourceStatusReason (\s a -> s { _srsResourceStatusReason = a }) --- | Type of resource. (For more information, go to AWS Resource Types--- Reference in the AWS CloudFormation User Guide.).+-- | 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.) srsResourceType :: Lens' StackResourceSummary Text srsResourceType = lens _srsResourceType (\s a -> s { _srsResourceType = a }) @@ -1101,7 +1105,10 @@ instance Hashable Capability instance FromText Capability where- parser = match "CAPABILITY_IAM" CapabilityIam+ parser = takeText >>= \case+ "CAPABILITY_IAM" -> pure CapabilityIam+ e -> fail $+ "Failure parsing Capability from " ++ show e instance ToText Capability where toText CapabilityIam = "CAPABILITY_IAM"@@ -1113,7 +1120,6 @@ instance FromXML Capability where parseXML = parseXMLText "Capability" - data ResourceSignalStatus = Failure -- ^ FAILURE | Success -- ^ SUCCESS@@ -1122,8 +1128,11 @@ instance Hashable ResourceSignalStatus instance FromText ResourceSignalStatus where- parser = match "FAILURE" Failure- <|> match "SUCCESS" Success+ parser = takeText >>= \case+ "FAILURE" -> pure Failure+ "SUCCESS" -> pure Success+ e -> fail $+ "Failure parsing ResourceSignalStatus from " ++ show e instance ToText ResourceSignalStatus where toText = \case@@ -1137,13 +1146,12 @@ instance FromXML ResourceSignalStatus where parseXML = parseXMLText "ResourceSignalStatus" - data Stack = Stack { _sCapabilities :: List "Capabilities" Capability- , _sCreationTime :: RFC822+ , _sCreationTime :: ISO8601 , _sDescription :: Maybe Text , _sDisableRollback :: Maybe Bool- , _sLastUpdatedTime :: Maybe RFC822+ , _sLastUpdatedTime :: Maybe ISO8601 , _sNotificationARNs :: List "NotificationARNs" Text , _sOutputs :: List "Outputs" Output , _sParameters :: List "Parameters" Parameter@@ -1220,13 +1228,14 @@ sDescription :: Lens' Stack (Maybe Text) sDescription = lens _sDescription (\s a -> s { _sDescription = a }) --- | 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 }) --- | The time the stack was last updated. This field will only be returned if--- the stack has been updated at least once.+-- | The time the stack was last updated. This field will only be returned if the+-- stack has been updated at least once. sLastUpdatedTime :: Lens' Stack (Maybe UTCTime) sLastUpdatedTime = lens _sLastUpdatedTime (\s a -> s { _sLastUpdatedTime = a }) . mapping _Time @@ -1240,7 +1249,7 @@ sOutputs :: Lens' Stack [Output] sOutputs = lens _sOutputs (\s a -> s { _sOutputs = a }) . _List --- | A list of Parameter structures.+-- | A list of 'Parameter' structures. sParameters :: Lens' Stack [Parameter] sParameters = lens _sParameters (\s a -> s { _sParameters = a }) . _List @@ -1261,7 +1270,7 @@ sStackStatusReason = lens _sStackStatusReason (\s a -> s { _sStackStatusReason = a }) --- | A list of Tags that specify cost allocation information for the stack.+-- | A list of 'Tag's that specify cost allocation information for the stack. sTags :: Lens' Stack [Tag] sTags = lens _sTags (\s a -> s { _sTags = a }) . _List @@ -1315,9 +1324,12 @@ instance Hashable OnFailure instance FromText OnFailure where- parser = match "DELETE" Delete'- <|> match "DO_NOTHING" DoNothing- <|> match "ROLLBACK" Rollback+ parser = takeText >>= \case+ "DELETE" -> pure Delete'+ "DO_NOTHING" -> pure DoNothing+ "ROLLBACK" -> pure Rollback+ e -> fail $+ "Failure parsing OnFailure from " ++ show e instance ToText OnFailure where toText = \case@@ -1332,7 +1344,6 @@ instance FromXML OnFailure where parseXML = parseXMLText "OnFailure" - data Parameter = Parameter { _pParameterKey :: Maybe Text , _pParameterValue :: Maybe Text@@ -1364,8 +1375,8 @@ pParameterValue :: Lens' Parameter (Maybe Text) pParameterValue = lens _pParameterValue (\s a -> s { _pParameterValue = a }) --- | During a stack update, use the existing parameter value that is being--- used for the stack.+-- | During a stack update, use the existing parameter value that is being used+-- for the stack. pUsePreviousValue :: Lens' Parameter (Maybe Bool) pUsePreviousValue = lens _pUsePreviousValue (\s a -> s { _pUsePreviousValue = a })
gen/Network/AWS/CloudFormation/UpdateStack.hs view
@@ -21,14 +21,17 @@ -- 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. To get a copy of the template for an--- existing stack, you can use the GetTemplate action. Tags that were--- associated with this stack during creation time will still be associated--- with the stack after an UpdateStack operation. For more information about--- creating an update template, updating a stack, and monitoring the progress--- of the update, see Updating a Stack.+-- 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.+--+-- Tags that were associated with this stack during creation time will still be+-- associated with the stack after an 'UpdateStack' operation.+--+-- 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>.+-- -- <http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStack.html> module Network.AWS.CloudFormation.UpdateStack (@@ -118,101 +121,101 @@ , _usNotificationARNs = mempty } --- | A list of capabilities that you must specify before AWS CloudFormation--- can create or update certain stacks. Some stack templates might include--- resources that can affect permissions in your AWS account. For those--- stacks, you must explicitly acknowledge their capabilities by specifying--- this parameter. Currently, the only valid value is CAPABILITY_IAM, which--- is required for the following resources: AWS::CloudFormation::Stack,--- AWS::IAM::AccessKey, AWS::IAM::Group, AWS::IAM::InstanceProfile,--- AWS::IAM::Policy, AWS::IAM::Role, AWS::IAM::User, and--- AWS::IAM::UserToGroupAddition. If your stack template contains these--- resources, we recommend that you review any permissions associated with--- them. If you don't specify this parameter, this action returns an--- InsufficientCapabilities error.+-- | A list of capabilities that you must specify before AWS CloudFormation can+-- create or update certain stacks. Some stack templates might include resources+-- that can affect permissions in your AWS account. For those stacks, you must+-- explicitly acknowledge their capabilities by specifying this parameter.+-- Currently, the only valid value is 'CAPABILITY_IAM', which is required for the+-- following resources: <http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html AWS::CloudFormation::Stack>, <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 any+-- permissions associated with them. If you don't specify this parameter, this+-- action returns an InsufficientCapabilities error. usCapabilities :: Lens' UpdateStack [Capability] usCapabilities = lens _usCapabilities (\s a -> s { _usCapabilities = a }) . _List --- | Update the ARNs for the Amazon SNS topics that are associated with the--- stack.+-- | Update the ARNs for the Amazon SNS topics that are associated with the stack. usNotificationARNs :: Lens' UpdateStack [Text] usNotificationARNs = lens _usNotificationARNs (\s a -> s { _usNotificationARNs = a }) . _List --- | A list of Parameter structures that specify input parameters for the--- stack.+-- | A list of 'Parameter' structures that specify input parameters for the stack. usParameters :: Lens' UpdateStack [Parameter] usParameters = lens _usParameters (\s a -> s { _usParameters = a }) . _List --- | The name or stack ID of the stack to update. Must contain only--- alphanumeric characters (case sensitive) and start with an alpha--- character. Maximum length of the name is 255 characters.+-- | The name or stack ID of the stack to update.+--+-- Must contain only alphanumeric characters (case sensitive) and start with+-- an alpha character. Maximum length of the name is 255 characters. usStackName :: Lens' UpdateStack Text usStackName = lens _usStackName (\s a -> s { _usStackName = a }) --- | 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+-- | 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.+-- 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 }) --- | 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--- 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 located in an S3 bucket in the same region as the stack. For--- more information, go to Template Anatomy in the AWS CloudFormation User--- Guide. Conditional: You must specify either the TemplateBody or the--- TemplateURL parameter, but not both.+-- template located in an S3 bucket in the same region as the stack. 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 }) --- | Reuse the existing template that is associated with the stack that you--- are updating.+-- | Reuse the existing template that is associated with the stack that you are+-- updating. usUsePreviousTemplate :: Lens' UpdateStack (Maybe Bool) usUsePreviousTemplate = lens _usUsePreviousTemplate (\s a -> s { _usUsePreviousTemplate = a })
gen/Network/AWS/CloudFormation/ValidateTemplate.hs view
@@ -68,19 +68,22 @@ , _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--- 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: 307,200 bytes) located in an S3 bucket in the same--- region as the stack. For more information, go to Template Anatomy in the--- AWS CloudFormation User Guide. Conditional: You must pass TemplateURL or--- TemplateBody. If both are passed, only TemplateBody is used.+-- template (max size: 307,200 bytes) located in an S3 bucket in the same region+-- as the stack. 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 }) @@ -112,11 +115,10 @@ } -- | The capabilities found within the template. Currently, AWS CloudFormation--- supports only the CAPABILITY_IAM capability. If your template contains--- IAM resources, you must specify the CAPABILITY_IAM value for this--- parameter when you use the CreateStack or UpdateStack actions with your--- template; otherwise, those actions return an InsufficientCapabilities--- error.+-- supports only the CAPABILITY_IAM capability. If your template contains IAM+-- resources, you must specify the CAPABILITY_IAM value for this parameter when+-- you use the 'CreateStack' or 'UpdateStack' actions with your template; otherwise,+-- those actions return an InsufficientCapabilities error. vtrCapabilities :: Lens' ValidateTemplateResponse [Capability] vtrCapabilities = lens _vtrCapabilities (\s a -> s { _vtrCapabilities = a }) . _List @@ -129,7 +131,7 @@ vtrDescription :: Lens' ValidateTemplateResponse (Maybe Text) vtrDescription = lens _vtrDescription (\s a -> s { _vtrDescription = a }) --- | A list of TemplateParameter structures.+-- | A list of 'TemplateParameter' structures. vtrParameters :: Lens' ValidateTemplateResponse [TemplateParameter] vtrParameters = lens _vtrParameters (\s a -> s { _vtrParameters = a }) . _List