amazonka-opsworks-1.3.0: Amazon OpsWorks SDK.

Copyright(c) 2013-2015 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <>
Portabilitynon-portable (GHC extensions)
Safe HaskellNone




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.

See: AWS API Reference for UpdateLayer.


Creating a Request

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.

We strongly recommend using the default value of true, to ensure that your instances have the latest security updates.

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 OpsWorksand 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. 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 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.