Interface Layer.Builder
- All Superinterfaces:
Buildable
,CopyableBuilder<Layer.Builder,
,Layer> SdkBuilder<Layer.Builder,
,Layer> SdkPojo
- Enclosing class:
Layer
-
Method Summary
Modifier and TypeMethodDescriptionThe Amazon Resource Number (ARN) of a layer.attributes
(Map<LayerAttributesKeys, String> attributes) The layer attributes.attributesWithStrings
(Map<String, String> attributes) The layer attributes.autoAssignElasticIps
(Boolean autoAssignElasticIps) Whether to automatically assign an Elastic IP address to the layer's instances.autoAssignPublicIps
(Boolean autoAssignPublicIps) For stacks that are running in a VPC, whether to automatically assign a public IP address to the layer's instances.default Layer.Builder
cloudWatchLogsConfiguration
(Consumer<CloudWatchLogsConfiguration.Builder> cloudWatchLogsConfiguration) The Amazon CloudWatch Logs configuration settings for the layer.cloudWatchLogsConfiguration
(CloudWatchLogsConfiguration cloudWatchLogsConfiguration) The Amazon CloudWatch Logs configuration settings for the layer.Date when the layer was created.customInstanceProfileArn
(String customInstanceProfileArn) The ARN of the default IAM profile to be used for the layer's EC2 instances.customJson
(String customJson) A JSON formatted string containing the layer's custom stack configuration and deployment attributes.default Layer.Builder
customRecipes
(Consumer<Recipes.Builder> customRecipes) ALayerCustomRecipes
object that specifies the layer's custom recipes.customRecipes
(Recipes customRecipes) ALayerCustomRecipes
object that specifies the layer's custom recipes.customSecurityGroupIds
(String... customSecurityGroupIds) An array containing the layer's custom security group IDs.customSecurityGroupIds
(Collection<String> customSecurityGroupIds) An array containing the layer's custom security group IDs.default Layer.Builder
defaultRecipes
(Consumer<Recipes.Builder> defaultRecipes) AWS OpsWorks Stacks supports five lifecycle events: setup, configuration, deploy, undeploy, and shutdown.defaultRecipes
(Recipes defaultRecipes) AWS OpsWorks Stacks supports five lifecycle events: setup, configuration, deploy, undeploy, and shutdown.defaultSecurityGroupNames
(String... defaultSecurityGroupNames) An array containing the layer's security group names.defaultSecurityGroupNames
(Collection<String> defaultSecurityGroupNames) An array containing the layer's security group names.enableAutoHealing
(Boolean enableAutoHealing) Whether auto healing is disabled for the layer.installUpdatesOnBoot
(Boolean installUpdatesOnBoot) Whether to install operating system and package updates when the instance boots.The layer ID.default Layer.Builder
lifecycleEventConfiguration
(Consumer<LifecycleEventConfiguration.Builder> lifecycleEventConfiguration) ALifeCycleEventConfiguration
object that specifies the Shutdown event configuration.lifecycleEventConfiguration
(LifecycleEventConfiguration lifecycleEventConfiguration) ALifeCycleEventConfiguration
object that specifies the Shutdown event configuration.The layer name.An array ofPackage
objects that describe the layer's packages.packages
(Collection<String> packages) An array ofPackage
objects that describe the layer's packages.The layer short name.The layer stack ID.The layer type.The layer type.useEbsOptimizedInstances
(Boolean useEbsOptimizedInstances) Whether the layer uses Amazon EBS-optimized instances.volumeConfigurations
(Collection<VolumeConfiguration> volumeConfigurations) AVolumeConfigurations
object that describes the layer's Amazon EBS volumes.volumeConfigurations
(Consumer<VolumeConfiguration.Builder>... volumeConfigurations) AVolumeConfigurations
object that describes the layer's Amazon EBS volumes.volumeConfigurations
(VolumeConfiguration... volumeConfigurations) AVolumeConfigurations
object that describes the layer's Amazon EBS volumes.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
arn
The Amazon Resource Number (ARN) of a layer.
- Parameters:
arn
- The Amazon Resource Number (ARN) of a layer.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
stackId
The layer stack ID.
- Parameters:
stackId
- The layer stack ID.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
layerId
The layer ID.
- Parameters:
layerId
- The layer ID.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
type
The layer type.
- Parameters:
type
- The layer type.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
type
The layer type.
- Parameters:
type
- The layer type.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
name
The layer name.
- Parameters:
name
- The layer name.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
shortname
The layer short name.
- Parameters:
shortname
- The layer short name.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
attributesWithStrings
The layer attributes.
For the
HaproxyStatsPassword
,MysqlRootPassword
, andGangliaPassword
attributes, AWS OpsWorks Stacks returns*****FILTERED*****
instead of the actual valueFor an ECS Cluster layer, AWS OpsWorks Stacks the
EcsClusterArn
attribute is set to the cluster's ARN.- Parameters:
attributes
- The layer attributes.For the
HaproxyStatsPassword
,MysqlRootPassword
, andGangliaPassword
attributes, AWS OpsWorks Stacks returns*****FILTERED*****
instead of the actual valueFor an ECS Cluster layer, AWS OpsWorks Stacks the
EcsClusterArn
attribute is set to the cluster's ARN.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
attributes
The layer attributes.
For the
HaproxyStatsPassword
,MysqlRootPassword
, andGangliaPassword
attributes, AWS OpsWorks Stacks returns*****FILTERED*****
instead of the actual valueFor an ECS Cluster layer, AWS OpsWorks Stacks the
EcsClusterArn
attribute is set to the cluster's ARN.- Parameters:
attributes
- The layer attributes.For the
HaproxyStatsPassword
,MysqlRootPassword
, andGangliaPassword
attributes, AWS OpsWorks Stacks returns*****FILTERED*****
instead of the actual valueFor an ECS Cluster layer, AWS OpsWorks Stacks the
EcsClusterArn
attribute is set to the cluster's ARN.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
cloudWatchLogsConfiguration
The Amazon CloudWatch Logs configuration settings for the layer.
- Parameters:
cloudWatchLogsConfiguration
- The Amazon CloudWatch Logs configuration settings for the layer.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
cloudWatchLogsConfiguration
default Layer.Builder cloudWatchLogsConfiguration(Consumer<CloudWatchLogsConfiguration.Builder> cloudWatchLogsConfiguration) The Amazon CloudWatch Logs configuration settings for the layer.
This is a convenience method that creates an instance of theCloudWatchLogsConfiguration.Builder
avoiding the need to create one manually viaCloudWatchLogsConfiguration.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tocloudWatchLogsConfiguration(CloudWatchLogsConfiguration)
.- Parameters:
cloudWatchLogsConfiguration
- a consumer that will call methods onCloudWatchLogsConfiguration.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
customInstanceProfileArn
The ARN of the default IAM profile to be used for the layer's EC2 instances. For more information about IAM ARNs, see Using Identifiers.
- Parameters:
customInstanceProfileArn
- The ARN of the default IAM profile to be used for the layer's EC2 instances. For more information about IAM ARNs, see Using Identifiers.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
customJson
A JSON formatted string containing the layer's custom stack configuration and deployment attributes.
- Parameters:
customJson
- A JSON formatted string containing the layer's custom stack configuration and deployment attributes.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
customSecurityGroupIds
An array containing the layer's custom security group IDs.
- Parameters:
customSecurityGroupIds
- An array containing the layer's custom security group IDs.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
customSecurityGroupIds
An array containing the layer's custom security group IDs.
- Parameters:
customSecurityGroupIds
- An array containing the layer's custom security group IDs.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
defaultSecurityGroupNames
An array containing the layer's security group names.
- Parameters:
defaultSecurityGroupNames
- An array containing the layer's security group names.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
defaultSecurityGroupNames
An array containing the layer's security group names.
- Parameters:
defaultSecurityGroupNames
- An array containing the layer's security group names.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
packages
An array of
Package
objects that describe the layer's packages.- Parameters:
packages
- An array ofPackage
objects that describe the layer's packages.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
packages
An array of
Package
objects that describe the layer's packages.- Parameters:
packages
- An array ofPackage
objects that describe the layer's packages.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
volumeConfigurations
A
VolumeConfigurations
object that describes the layer's Amazon EBS volumes.- Parameters:
volumeConfigurations
- AVolumeConfigurations
object that describes the layer's Amazon EBS volumes.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
volumeConfigurations
A
VolumeConfigurations
object that describes the layer's Amazon EBS volumes.- Parameters:
volumeConfigurations
- AVolumeConfigurations
object that describes the layer's Amazon EBS volumes.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
volumeConfigurations
A
This is a convenience method that creates an instance of theVolumeConfigurations
object that describes the layer's Amazon EBS volumes.VolumeConfiguration.Builder
avoiding the need to create one manually viaVolumeConfiguration.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tovolumeConfigurations(List<VolumeConfiguration>)
.- Parameters:
volumeConfigurations
- a consumer that will call methods onVolumeConfiguration.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
enableAutoHealing
Whether auto healing is disabled for the layer.
- Parameters:
enableAutoHealing
- Whether auto healing is disabled for the layer.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
autoAssignElasticIps
Whether to automatically assign an Elastic IP address to the layer's instances. For more information, see How to Edit a Layer.
- Parameters:
autoAssignElasticIps
- Whether to automatically assign an Elastic IP address to the layer's instances. For more information, see How to Edit a Layer.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
autoAssignPublicIps
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.
- Parameters:
autoAssignPublicIps
- 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.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
defaultRecipes
AWS OpsWorks Stacks supports five lifecycle events: setup, configuration, deploy, undeploy, and shutdown. For each layer, AWS OpsWorks Stacks runs a set of standard recipes for each event. You can also provide custom recipes for any or all layers and events. AWS OpsWorks Stacks runs custom event recipes after the standard recipes.
LayerCustomRecipes
specifies the custom recipes for a particular layer to be run in response to each of the five events.To specify a recipe, use the cookbook's directory name in the repository followed by two colons and the recipe name, which is the recipe's file name without the
.rb
extension. For example:phpapp2::dbsetup
specifies thedbsetup.rb
recipe in the repository'sphpapp2
folder.- Parameters:
defaultRecipes
- AWS OpsWorks Stacks supports five lifecycle events: setup, configuration, deploy, undeploy, and shutdown. For each layer, AWS OpsWorks Stacks runs a set of standard recipes for each event. You can also provide custom recipes for any or all layers and events. AWS OpsWorks Stacks runs custom event recipes after the standard recipes.LayerCustomRecipes
specifies the custom recipes for a particular layer to be run in response to each of the five events.To specify a recipe, use the cookbook's directory name in the repository followed by two colons and the recipe name, which is the recipe's file name without the
.rb
extension. For example:phpapp2::dbsetup
specifies thedbsetup.rb
recipe in the repository'sphpapp2
folder.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
defaultRecipes
AWS OpsWorks Stacks supports five lifecycle events: setup, configuration, deploy, undeploy, and shutdown. For each layer, AWS OpsWorks Stacks runs a set of standard recipes for each event. You can also provide custom recipes for any or all layers and events. AWS OpsWorks Stacks runs custom event recipes after the standard recipes.
LayerCustomRecipes
specifies the custom recipes for a particular layer to be run in response to each of the five events.To specify a recipe, use the cookbook's directory name in the repository followed by two colons and the recipe name, which is the recipe's file name without the
This is a convenience method that creates an instance of the.rb
extension. For example:phpapp2::dbsetup
specifies thedbsetup.rb
recipe in the repository'sphpapp2
folder.Recipes.Builder
avoiding the need to create one manually viaRecipes.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed todefaultRecipes(Recipes)
.- Parameters:
defaultRecipes
- a consumer that will call methods onRecipes.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
customRecipes
A
LayerCustomRecipes
object that specifies the layer's custom recipes.- Parameters:
customRecipes
- ALayerCustomRecipes
object that specifies the layer's custom recipes.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
customRecipes
A
This is a convenience method that creates an instance of theLayerCustomRecipes
object that specifies the layer's custom recipes.Recipes.Builder
avoiding the need to create one manually viaRecipes.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tocustomRecipes(Recipes)
.- Parameters:
customRecipes
- a consumer that will call methods onRecipes.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
createdAt
Date when the layer was created.
- Parameters:
createdAt
- Date when the layer was created.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
installUpdatesOnBoot
Whether to install operating system and package updates when the instance boots. The default value is
true
. If this value is set tofalse
, you must then update your instances manually by using CreateDeployment to run theupdate_dependencies
stack command or manually runningyum
(Amazon Linux) orapt-get
(Ubuntu) on the instances.We strongly recommend using the default value of
true
, to ensure that your instances have the latest security updates.- Parameters:
installUpdatesOnBoot
- Whether to install operating system and package updates when the instance boots. The default value istrue
. If this value is set tofalse
, you must then update your instances manually by using CreateDeployment to run theupdate_dependencies
stack command or manually runningyum
(Amazon Linux) orapt-get
(Ubuntu) on the instances.We strongly recommend using the default value of
true
, to ensure that your instances have the latest security updates.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
useEbsOptimizedInstances
Whether the layer uses Amazon EBS-optimized instances.
- Parameters:
useEbsOptimizedInstances
- Whether the layer uses Amazon EBS-optimized instances.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
lifecycleEventConfiguration
A
LifeCycleEventConfiguration
object that specifies the Shutdown event configuration.- Parameters:
lifecycleEventConfiguration
- ALifeCycleEventConfiguration
object that specifies the Shutdown event configuration.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
lifecycleEventConfiguration
default Layer.Builder lifecycleEventConfiguration(Consumer<LifecycleEventConfiguration.Builder> lifecycleEventConfiguration) A
This is a convenience method that creates an instance of theLifeCycleEventConfiguration
object that specifies the Shutdown event configuration.LifecycleEventConfiguration.Builder
avoiding the need to create one manually viaLifecycleEventConfiguration.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tolifecycleEventConfiguration(LifecycleEventConfiguration)
.- Parameters:
lifecycleEventConfiguration
- a consumer that will call methods onLifecycleEventConfiguration.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-