amazonka-opsworks-1.6.0: Amazon OpsWorks SDK.

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

Network.AWS.OpsWorks.UpdateLayer

Contents

Description

Updates a specified layer.

Required Permissions : To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions .

Synopsis

Creating a Request

updateLayer Source #

Arguments

:: Text

ulLayerId

-> UpdateLayer 

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

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

  • ulCustomInstanceProfileARN - The ARN of an IAM profile to be used for all of the layer's EC2 instances. For more information about IAM ARNs, see Using Identifiers .
  • ulCustomSecurityGroupIds - An array containing the layer's custom security group IDs.
  • ulInstallUpdatesOnBoot - Whether to install operating system and package updates when the instance boots. The default value is true . To control when updates are installed, set this value to false . You must then update your instances manually by using CreateDeployment to run the update_dependencies stack command or manually running yum (Amazon Linux) or apt-get (Ubuntu) on the instances.
  • ulCloudWatchLogsConfiguration - Specifies CloudWatch Logs configuration options for the layer. For more information, see CloudWatchLogsLogStream .
  • ulLifecycleEventConfiguration -
  • ulShortname - For custom layers only, use this parameter to specify the layer's short name, which is used internally by AWS OpsWorks Stacks and by Chef. The short name is also used as the name for the directory where your app files are installed. It can have a maximum of 200 characters and must be in the following format: A[a-z0-9-_.]+Z. The built-in layers' short names are defined by AWS OpsWorks Stacks. For more information, see the Layer Reference
  • ulCustomRecipes - A LayerCustomRecipes object that specifies the layer's custom recipes.
  • ulCustomJSON - A JSON-formatted string containing custom stack configuration and deployment attributes to be installed on the layer's instances. For more information, see Using Custom JSON .
  • ulVolumeConfigurations - A VolumeConfigurations object that describes the layer's Amazon EBS volumes.
  • ulEnableAutoHealing - Whether to disable auto healing for the layer.
  • ulPackages - An array of Package objects that describe the layer's packages.
  • ulAttributes - One or more user-defined key/value pairs to be added to the stack attributes.
  • ulName - The layer name, which is used by the console.
  • ulAutoAssignPublicIPs - For stacks that are running in a VPC, whether to automatically assign a public IP address to the layer's instances. For more information, see How to Edit a Layer .
  • ulUseEBSOptimizedInstances - Whether to use Amazon EBS-optimized instances.
  • ulAutoAssignElasticIPs - Whether to automatically assign an Elastic IP address to the layer's instances. For more information, see How to Edit a Layer .
  • ulLayerId - The layer ID.

data UpdateLayer Source #

See: updateLayer smart constructor.

Instances

Eq UpdateLayer Source # 
Data UpdateLayer Source # 

Methods

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

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

toConstr :: UpdateLayer -> Constr #

dataTypeOf :: UpdateLayer -> DataType #

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

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

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

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

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

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

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

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

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

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

Read UpdateLayer Source # 
Show UpdateLayer Source # 
Generic UpdateLayer Source # 

Associated Types

type Rep UpdateLayer :: * -> * #

Hashable UpdateLayer Source # 
ToJSON UpdateLayer Source # 
NFData UpdateLayer Source # 

Methods

rnf :: UpdateLayer -> () #

AWSRequest UpdateLayer Source # 
ToHeaders UpdateLayer Source # 

Methods

toHeaders :: UpdateLayer -> [Header] #

ToPath UpdateLayer Source # 
ToQuery UpdateLayer Source # 
type Rep UpdateLayer Source # 
type Rep UpdateLayer = D1 * (MetaData "UpdateLayer" "Network.AWS.OpsWorks.UpdateLayer" "amazonka-opsworks-1.6.0-dhw3H9lmJm2qKjEl8vg7Z" False) (C1 * (MetaCons "UpdateLayer'" PrefixI True) ((:*:) * ((:*:) * ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_ulCustomInstanceProfileARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_ulCustomSecurityGroupIds") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe [Text])))) ((:*:) * (S1 * (MetaSel (Just Symbol "_ulInstallUpdatesOnBoot") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Bool))) (S1 * (MetaSel (Just Symbol "_ulCloudWatchLogsConfiguration") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe CloudWatchLogsConfiguration))))) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_ulLifecycleEventConfiguration") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe LifecycleEventConfiguration))) (S1 * (MetaSel (Just Symbol "_ulShortname") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_ulCustomRecipes") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Recipes))) (S1 * (MetaSel (Just Symbol "_ulCustomJSON") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text)))))) ((:*:) * ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_ulVolumeConfigurations") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe [VolumeConfiguration]))) (S1 * (MetaSel (Just Symbol "_ulEnableAutoHealing") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Bool)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_ulPackages") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe [Text]))) (S1 * (MetaSel (Just Symbol "_ulAttributes") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe (Map LayerAttributesKeys (Maybe Text))))))) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_ulName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_ulAutoAssignPublicIPs") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Bool)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_ulUseEBSOptimizedInstances") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Bool))) ((:*:) * (S1 * (MetaSel (Just Symbol "_ulAutoAssignElasticIPs") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Bool))) (S1 * (MetaSel (Just Symbol "_ulLayerId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text))))))))
type Rs UpdateLayer Source # 

Request Lenses

ulCustomInstanceProfileARN :: Lens' UpdateLayer (Maybe Text) Source #

The ARN of an IAM profile to be used for all of the layer's EC2 instances. For more information about IAM ARNs, see Using Identifiers .

ulCustomSecurityGroupIds :: Lens' UpdateLayer [Text] Source #

An array containing the layer's custom security group IDs.

ulInstallUpdatesOnBoot :: Lens' UpdateLayer (Maybe Bool) Source #

Whether to install operating system and package updates when the instance boots. The default value is true . To control when updates are installed, set this value to false . You must then update your instances manually by using CreateDeployment to run the update_dependencies stack command or manually running yum (Amazon Linux) or apt-get (Ubuntu) on the instances.

ulCloudWatchLogsConfiguration :: Lens' UpdateLayer (Maybe CloudWatchLogsConfiguration) Source #

Specifies CloudWatch Logs configuration options for the layer. For more information, see CloudWatchLogsLogStream .

ulShortname :: Lens' UpdateLayer (Maybe Text) Source #

For custom layers only, use this parameter to specify the layer's short name, which is used internally by AWS OpsWorks Stacks and by Chef. The short name is also used as the name for the directory where your app files are installed. It can have a maximum of 200 characters and must be in the following format: A[a-z0-9-_.]+Z. The built-in layers' short names are defined by AWS OpsWorks Stacks. For more information, see the Layer Reference

ulCustomRecipes :: Lens' UpdateLayer (Maybe Recipes) Source #

A LayerCustomRecipes object that specifies the layer's custom recipes.

ulCustomJSON :: Lens' UpdateLayer (Maybe Text) Source #

A JSON-formatted string containing custom stack configuration and deployment attributes to be installed on the layer's instances. For more information, see Using Custom JSON .

ulVolumeConfigurations :: Lens' UpdateLayer [VolumeConfiguration] Source #

A VolumeConfigurations object that describes the layer's Amazon EBS volumes.

ulEnableAutoHealing :: Lens' UpdateLayer (Maybe Bool) Source #

Whether to disable auto healing for the layer.

ulPackages :: Lens' UpdateLayer [Text] Source #

An array of Package objects that describe the layer's packages.

ulAttributes :: Lens' UpdateLayer (HashMap LayerAttributesKeys (Maybe Text)) Source #

One or more user-defined key/value pairs to be added to the stack attributes.

ulName :: Lens' UpdateLayer (Maybe Text) Source #

The layer name, which is used by the console.

ulAutoAssignPublicIPs :: Lens' UpdateLayer (Maybe Bool) Source #

For stacks that are running in a VPC, whether to automatically assign a public IP address to the layer's instances. For more information, see How to Edit a Layer .

ulUseEBSOptimizedInstances :: Lens' UpdateLayer (Maybe Bool) Source #

Whether to use Amazon EBS-optimized instances.

ulAutoAssignElasticIPs :: Lens' UpdateLayer (Maybe Bool) Source #

Whether to automatically assign an Elastic IP address to the layer's instances. For more information, see How to Edit a Layer .

Destructuring the Response

updateLayerResponse :: UpdateLayerResponse Source #

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

data UpdateLayerResponse Source #

See: updateLayerResponse smart constructor.

Instances

Eq UpdateLayerResponse Source # 
Data UpdateLayerResponse Source # 

Methods

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

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

toConstr :: UpdateLayerResponse -> Constr #

dataTypeOf :: UpdateLayerResponse -> DataType #

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

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

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

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

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

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

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

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

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

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

Read UpdateLayerResponse Source # 
Show UpdateLayerResponse Source # 
Generic UpdateLayerResponse Source # 
NFData UpdateLayerResponse Source # 

Methods

rnf :: UpdateLayerResponse -> () #

type Rep UpdateLayerResponse Source # 
type Rep UpdateLayerResponse = D1 * (MetaData "UpdateLayerResponse" "Network.AWS.OpsWorks.UpdateLayer" "amazonka-opsworks-1.6.0-dhw3H9lmJm2qKjEl8vg7Z" False) (C1 * (MetaCons "UpdateLayerResponse'" PrefixI False) (U1 *))