{-# LANGUAGE DataKinds #-} {-# LANGUAGE DeriveGeneric #-} {-# LANGUAGE FlexibleInstances #-} {-# LANGUAGE GeneralizedNewtypeDeriving #-} {-# LANGUAGE LambdaCase #-} {-# LANGUAGE NoImplicitPrelude #-} {-# LANGUAGE OverloadedStrings #-} {-# LANGUAGE RecordWildCards #-} {-# LANGUAGE TypeFamilies #-} {-# OPTIONS_GHC -fno-warn-unused-imports #-} -- Module : Network.AWS.OpsWorks.CloneStack -- Copyright : (c) 2013-2014 Brendan Hay <brendan.g.hay@gmail.com> -- License : This Source Code Form is subject to the terms of -- the Mozilla Public License, v. 2.0. -- A copy of the MPL can be found in the LICENSE file or -- you can obtain it at http://mozilla.org/MPL/2.0/. -- Maintainer : Brendan Hay <brendan.g.hay@gmail.com> -- Stability : experimental -- Portability : non-portable (GHC extensions) -- -- Derived from AWS service descriptions, licensed under Apache 2.0. -- | Creates a clone of a specified stack. For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-cloning.html Clone a Stack>. -- -- Required Permissions: To use this action, an IAM user must have an attached -- policy that explicitly grants permissions. For more information on user -- permissions, see <http://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html Managing User Permissions>. -- -- <http://docs.aws.amazon.com/opsworks/latest/APIReference/API_CloneStack.html> module Network.AWS.OpsWorks.CloneStack ( -- * Request CloneStack -- ** Request constructor , cloneStack -- ** Request lenses , cs1Attributes , cs1ChefConfiguration , cs1CloneAppIds , cs1ClonePermissions , cs1ConfigurationManager , cs1CustomCookbooksSource , cs1CustomJson , cs1DefaultAvailabilityZone , cs1DefaultInstanceProfileArn , cs1DefaultOs , cs1DefaultRootDeviceType , cs1DefaultSshKeyName , cs1DefaultSubnetId , cs1HostnameTheme , cs1Name , cs1Region , cs1ServiceRoleArn , cs1SourceStackId , cs1UseCustomCookbooks , cs1UseOpsworksSecurityGroups , cs1VpcId -- * Response , CloneStackResponse -- ** Response constructor , cloneStackResponse -- ** Response lenses , csrStackId ) where import Network.AWS.Prelude import Network.AWS.Request.JSON import Network.AWS.OpsWorks.Types import qualified GHC.Exts data CloneStack = CloneStack { _cs1Attributes :: Map StackAttributesKeys Text , _cs1ChefConfiguration :: Maybe ChefConfiguration , _cs1CloneAppIds :: List "CloneAppIds" Text , _cs1ClonePermissions :: Maybe Bool , _cs1ConfigurationManager :: Maybe StackConfigurationManager , _cs1CustomCookbooksSource :: Maybe Source , _cs1CustomJson :: Maybe Text , _cs1DefaultAvailabilityZone :: Maybe Text , _cs1DefaultInstanceProfileArn :: Maybe Text , _cs1DefaultOs :: Maybe Text , _cs1DefaultRootDeviceType :: Maybe RootDeviceType , _cs1DefaultSshKeyName :: Maybe Text , _cs1DefaultSubnetId :: Maybe Text , _cs1HostnameTheme :: Maybe Text , _cs1Name :: Maybe Text , _cs1Region :: Maybe Text , _cs1ServiceRoleArn :: Text , _cs1SourceStackId :: Text , _cs1UseCustomCookbooks :: Maybe Bool , _cs1UseOpsworksSecurityGroups :: Maybe Bool , _cs1VpcId :: Maybe Text } deriving (Eq, Show) -- | 'CloneStack' constructor. -- -- The fields accessible through corresponding lenses are: -- -- * 'cs1Attributes' @::@ 'HashMap' 'StackAttributesKeys' 'Text' -- -- * 'cs1ChefConfiguration' @::@ 'Maybe' 'ChefConfiguration' -- -- * 'cs1CloneAppIds' @::@ ['Text'] -- -- * 'cs1ClonePermissions' @::@ 'Maybe' 'Bool' -- -- * 'cs1ConfigurationManager' @::@ 'Maybe' 'StackConfigurationManager' -- -- * 'cs1CustomCookbooksSource' @::@ 'Maybe' 'Source' -- -- * 'cs1CustomJson' @::@ 'Maybe' 'Text' -- -- * 'cs1DefaultAvailabilityZone' @::@ 'Maybe' 'Text' -- -- * 'cs1DefaultInstanceProfileArn' @::@ 'Maybe' 'Text' -- -- * 'cs1DefaultOs' @::@ 'Maybe' 'Text' -- -- * 'cs1DefaultRootDeviceType' @::@ 'Maybe' 'RootDeviceType' -- -- * 'cs1DefaultSshKeyName' @::@ 'Maybe' 'Text' -- -- * 'cs1DefaultSubnetId' @::@ 'Maybe' 'Text' -- -- * 'cs1HostnameTheme' @::@ 'Maybe' 'Text' -- -- * 'cs1Name' @::@ 'Maybe' 'Text' -- -- * 'cs1Region' @::@ 'Maybe' 'Text' -- -- * 'cs1ServiceRoleArn' @::@ 'Text' -- -- * 'cs1SourceStackId' @::@ 'Text' -- -- * 'cs1UseCustomCookbooks' @::@ 'Maybe' 'Bool' -- -- * 'cs1UseOpsworksSecurityGroups' @::@ 'Maybe' 'Bool' -- -- * 'cs1VpcId' @::@ 'Maybe' 'Text' -- cloneStack :: Text -- ^ 'cs1SourceStackId' -> Text -- ^ 'cs1ServiceRoleArn' -> CloneStack cloneStack p1 p2 = CloneStack { _cs1SourceStackId = p1 , _cs1ServiceRoleArn = p2 , _cs1Name = Nothing , _cs1Region = Nothing , _cs1VpcId = Nothing , _cs1Attributes = mempty , _cs1DefaultInstanceProfileArn = Nothing , _cs1DefaultOs = Nothing , _cs1HostnameTheme = Nothing , _cs1DefaultAvailabilityZone = Nothing , _cs1DefaultSubnetId = Nothing , _cs1CustomJson = Nothing , _cs1ConfigurationManager = Nothing , _cs1ChefConfiguration = Nothing , _cs1UseCustomCookbooks = Nothing , _cs1UseOpsworksSecurityGroups = Nothing , _cs1CustomCookbooksSource = Nothing , _cs1DefaultSshKeyName = Nothing , _cs1ClonePermissions = Nothing , _cs1CloneAppIds = mempty , _cs1DefaultRootDeviceType = Nothing } -- | A list of stack attributes and values as key/value pairs to be added to the -- cloned stack. cs1Attributes :: Lens' CloneStack (HashMap StackAttributesKeys Text) cs1Attributes = lens _cs1Attributes (\s a -> s { _cs1Attributes = a }) . _Map -- | A 'ChefConfiguration' object that specifies whether to enable Berkshelf and the -- Berkshelf version on Chef 11.10 stacks. For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html Create aNew Stack>. cs1ChefConfiguration :: Lens' CloneStack (Maybe ChefConfiguration) cs1ChefConfiguration = lens _cs1ChefConfiguration (\s a -> s { _cs1ChefConfiguration = a }) -- | A list of source stack app IDs to be included in the cloned stack. cs1CloneAppIds :: Lens' CloneStack [Text] cs1CloneAppIds = lens _cs1CloneAppIds (\s a -> s { _cs1CloneAppIds = a }) . _List -- | Whether to clone the source stack's permissions. cs1ClonePermissions :: Lens' CloneStack (Maybe Bool) cs1ClonePermissions = lens _cs1ClonePermissions (\s a -> s { _cs1ClonePermissions = a }) -- | The configuration manager. When you clone a stack we recommend that you use -- the configuration manager to specify the Chef version, 0.9, 11.4, or 11.10. -- The default value is currently 11.4. cs1ConfigurationManager :: Lens' CloneStack (Maybe StackConfigurationManager) cs1ConfigurationManager = lens _cs1ConfigurationManager (\s a -> s { _cs1ConfigurationManager = a }) cs1CustomCookbooksSource :: Lens' CloneStack (Maybe Source) cs1CustomCookbooksSource = lens _cs1CustomCookbooksSource (\s a -> s { _cs1CustomCookbooksSource = a }) -- | A string that contains user-defined, custom JSON. It is used to override the -- corresponding default stack configuration JSON values. The string should be -- in the following format and must escape characters such as '"'.: -- -- '"{\"key1\": \"value1\", \"key2\": \"value2\",...}"' -- -- For more information on custom JSON, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-json.html Use Custom JSON to Modify the StackConfiguration JSON> cs1CustomJson :: Lens' CloneStack (Maybe Text) cs1CustomJson = lens _cs1CustomJson (\s a -> s { _cs1CustomJson = a }) -- | The cloned stack's default Availability Zone, which must be in the specified -- region. For more information, see <http://docs.aws.amazon.com/general/latest/gr/rande.html Regions and Endpoints>. If you also specify -- a value for 'DefaultSubnetId', the subnet must be in the same zone. For more -- information, see the 'VpcId' parameter description. cs1DefaultAvailabilityZone :: Lens' CloneStack (Maybe Text) cs1DefaultAvailabilityZone = lens _cs1DefaultAvailabilityZone (\s a -> s { _cs1DefaultAvailabilityZone = a }) -- | The ARN of an IAM profile that is the default profile for all of the stack's -- EC2 instances. For more information about IAM ARNs, see <http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html Using Identifiers>. cs1DefaultInstanceProfileArn :: Lens' CloneStack (Maybe Text) cs1DefaultInstanceProfileArn = lens _cs1DefaultInstanceProfileArn (\s a -> s { _cs1DefaultInstanceProfileArn = a }) -- | The stacks's operating system, which must be set to one of the following. -- -- Standard operating systems: an Amazon Linux version such as 'Amazon Linux2014.09', 'Ubuntu 12.04 LTS', or 'Ubuntu 14.04 LTS'. Custom AMIs: 'Custom'. You -- specify the custom AMI you want to use when you create instances. The -- default option is the current Amazon Linux version. cs1DefaultOs :: Lens' CloneStack (Maybe Text) cs1DefaultOs = lens _cs1DefaultOs (\s a -> s { _cs1DefaultOs = a }) -- | The default root device type. This value is used by default for all instances -- in the cloned stack, but you can override it when you create an instance. For -- more information, see <http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device Storage for the Root Device>. cs1DefaultRootDeviceType :: Lens' CloneStack (Maybe RootDeviceType) cs1DefaultRootDeviceType = lens _cs1DefaultRootDeviceType (\s a -> s { _cs1DefaultRootDeviceType = a }) -- | A default SSH key for the stack instances. You can override this value when -- you create or update an instance. cs1DefaultSshKeyName :: Lens' CloneStack (Maybe Text) cs1DefaultSshKeyName = lens _cs1DefaultSshKeyName (\s a -> s { _cs1DefaultSshKeyName = a }) -- | The stack's default VPC subnet ID. This parameter is required if you specify -- a value for the 'VpcId' parameter. All instances are launched into this subnet -- unless you specify otherwise when you create the instance. If you also -- specify a value for 'DefaultAvailabilityZone', the subnet must be in that zone. -- For information on default values and when this parameter is required, see -- the 'VpcId' parameter description. cs1DefaultSubnetId :: Lens' CloneStack (Maybe Text) cs1DefaultSubnetId = lens _cs1DefaultSubnetId (\s a -> s { _cs1DefaultSubnetId = a }) -- | The stack's host name theme, with spaces are replaced by underscores. The -- theme is used to generate host names for the stack's instances. By default, 'HostnameTheme' is set to 'Layer_Dependent', which creates host names by appending integers to -- the layer's short name. The other themes are: -- -- 'Baked_Goods' 'Clouds' 'European_Cities' 'Fruits' 'Greek_Deities' 'Legendary_Creatures_from_Japan' 'Planets_and_Moons' 'Roman_Deities' 'Scottish_Islands' 'US_Cities' 'Wild_Cats' To -- obtain a generated host name, call 'GetHostNameSuggestion', which returns a -- host name based on the current theme. cs1HostnameTheme :: Lens' CloneStack (Maybe Text) cs1HostnameTheme = lens _cs1HostnameTheme (\s a -> s { _cs1HostnameTheme = a }) -- | The cloned stack name. cs1Name :: Lens' CloneStack (Maybe Text) cs1Name = lens _cs1Name (\s a -> s { _cs1Name = a }) -- | The cloned stack AWS region, such as "us-east-1". For more information about -- AWS regions, see <http://docs.aws.amazon.com/general/latest/gr/rande.html Regions and Endpoints>. cs1Region :: Lens' CloneStack (Maybe Text) cs1Region = lens _cs1Region (\s a -> s { _cs1Region = a }) -- | The stack AWS Identity and Access Management (IAM) role, which allows AWS -- OpsWorks to work with AWS resources on your behalf. You must set this -- parameter to the Amazon Resource Name (ARN) for an existing IAM role. If you -- create a stack by using the AWS OpsWorks console, it creates the role for -- you. You can obtain an existing stack's IAM ARN programmatically by calling 'DescribePermissions'. For more information about IAM ARNs, see <http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html Using Identifiers>. -- -- You must set this parameter to a valid service role ARN or the action will -- fail; there is no default value. You can specify the source stack's service -- role ARN, if you prefer, but you must do so explicitly. -- -- cs1ServiceRoleArn :: Lens' CloneStack Text cs1ServiceRoleArn = lens _cs1ServiceRoleArn (\s a -> s { _cs1ServiceRoleArn = a }) -- | The source stack ID. cs1SourceStackId :: Lens' CloneStack Text cs1SourceStackId = lens _cs1SourceStackId (\s a -> s { _cs1SourceStackId = a }) -- | Whether to use custom cookbooks. cs1UseCustomCookbooks :: Lens' CloneStack (Maybe Bool) cs1UseCustomCookbooks = lens _cs1UseCustomCookbooks (\s a -> s { _cs1UseCustomCookbooks = a }) -- | Whether to associate the AWS OpsWorks built-in security groups with the -- stack's layers. -- -- AWS OpsWorks provides a standard set of built-in security groups, one for -- each layer, which are associated with layers by default. With 'UseOpsworksSecurityGroups' you can instead provide your own custom security groups. 'UseOpsworksSecurityGroups' has the following settings: -- -- True - AWS OpsWorks automatically associates the appropriate built-in -- security group with each layer (default setting). You can associate -- additional security groups with a layer after you create it but you cannot -- delete the built-in security group. False - AWS OpsWorks does not associate -- built-in security groups with layers. You must create appropriate EC2 -- security groups and associate a security group with each layer that you -- create. However, you can still manually associate a built-in security group -- with a layer on creation; custom security groups are required only for those -- layers that need custom settings. For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html Create a NewStack>. cs1UseOpsworksSecurityGroups :: Lens' CloneStack (Maybe Bool) cs1UseOpsworksSecurityGroups = lens _cs1UseOpsworksSecurityGroups (\s a -> s { _cs1UseOpsworksSecurityGroups = a }) -- | The ID of the VPC that the cloned stack is to be launched into. It must be in -- the specified region. All instances are launched into this VPC, and you -- cannot change the ID later. -- -- If your account supports EC2 Classic, the default value is no VPC. If your -- account does not support EC2 Classic, the default value is the default VPC -- for the specified region. If the VPC ID corresponds to a default VPC and you -- have specified either the 'DefaultAvailabilityZone' or the 'DefaultSubnetId' -- parameter only, AWS OpsWorks infers the value of the other parameter. If you -- specify neither parameter, AWS OpsWorks sets these parameters to the first -- valid Availability Zone for the specified region and the corresponding -- default VPC subnet ID, respectively. -- -- If you specify a nondefault VPC ID, note the following: -- -- It must belong to a VPC in your account that is in the specified region. You must specify a value for -- 'DefaultSubnetId'. For more information on how to use AWS OpsWorks with a VPC, -- see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-vpc.html Running a Stack in a VPC>. For more information on default VPC and EC2 -- Classic, see <http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-supported-platforms.html Supported Platforms>. cs1VpcId :: Lens' CloneStack (Maybe Text) cs1VpcId = lens _cs1VpcId (\s a -> s { _cs1VpcId = a }) newtype CloneStackResponse = CloneStackResponse { _csrStackId :: Maybe Text } deriving (Eq, Ord, Show, Monoid) -- | 'CloneStackResponse' constructor. -- -- The fields accessible through corresponding lenses are: -- -- * 'csrStackId' @::@ 'Maybe' 'Text' -- cloneStackResponse :: CloneStackResponse cloneStackResponse = CloneStackResponse { _csrStackId = Nothing } -- | The cloned stack ID. csrStackId :: Lens' CloneStackResponse (Maybe Text) csrStackId = lens _csrStackId (\s a -> s { _csrStackId = a }) instance ToPath CloneStack where toPath = const "/" instance ToQuery CloneStack where toQuery = const mempty instance ToHeaders CloneStack instance ToJSON CloneStack where toJSON CloneStack{..} = object [ "SourceStackId" .= _cs1SourceStackId , "Name" .= _cs1Name , "Region" .= _cs1Region , "VpcId" .= _cs1VpcId , "Attributes" .= _cs1Attributes , "ServiceRoleArn" .= _cs1ServiceRoleArn , "DefaultInstanceProfileArn" .= _cs1DefaultInstanceProfileArn , "DefaultOs" .= _cs1DefaultOs , "HostnameTheme" .= _cs1HostnameTheme , "DefaultAvailabilityZone" .= _cs1DefaultAvailabilityZone , "DefaultSubnetId" .= _cs1DefaultSubnetId , "CustomJson" .= _cs1CustomJson , "ConfigurationManager" .= _cs1ConfigurationManager , "ChefConfiguration" .= _cs1ChefConfiguration , "UseCustomCookbooks" .= _cs1UseCustomCookbooks , "UseOpsworksSecurityGroups" .= _cs1UseOpsworksSecurityGroups , "CustomCookbooksSource" .= _cs1CustomCookbooksSource , "DefaultSshKeyName" .= _cs1DefaultSshKeyName , "ClonePermissions" .= _cs1ClonePermissions , "CloneAppIds" .= _cs1CloneAppIds , "DefaultRootDeviceType" .= _cs1DefaultRootDeviceType ] instance AWSRequest CloneStack where type Sv CloneStack = OpsWorks type Rs CloneStack = CloneStackResponse request = post "CloneStack" response = jsonResponse instance FromJSON CloneStackResponse where parseJSON = withObject "CloneStackResponse" $ \o -> CloneStackResponse <$> o .:? "StackId"