layers Attributes
Important
AWS OpsWorks Stacks is no longer accepting new customers. Existing customers will be able to use the OpsWorks console, API, CLI, and CloudFormation resources as normal until May 26, 2024, at which time they will be discontinued. To prepare for this transition, we recommend you transition your stacks to AWS Systems Manager as soon as possible. For more information, see AWS OpsWorks Stacks End of Life FAQs and Migrating your AWS OpsWorks Stacks applications to AWS Systems Manager Application Manager.
The layers
attribute contains a set of layer attributes, one for each
of the stack's layers, which are named with the layer's short name, such as
php-app
. A stack can have at most one each of the built-in layers,
whose short names are as follows:
-
db-master
: MySQL layer -
java-app
: Java App Server layer -
lb
: HAProxy layer -
monitoring-master
: Ganglia layer -
memcached
: Memcached layer -
nodejs-app
: Node.js App Server layer -
php-app
: PHP App Server layer -
rails-app
: Rails App Server layer -
web
: Static Web Server layer
A stack can contain any number of custom layers, which have user-defined short names.
Each layer attribute contains the following attributes:
- id
-
The layer ID, which is a GUID that is generated by OpsWorks and uniquely identifies the layer (string).
node["opsworks"]["layers"]["
layershortname
"]["id"] - instances
-
The
instances
element contains a set of instance attributes, one for each of the layer's online instances. They are named with the instance's host name, such asphp-app1
.Note
The
instances
element contains only those instances that are in the online state when the particular stack configuration and deployment attributes are created.Each instance element contains the following attributes:
- availability_zone
-
The Availability Zone, such as
"us-west-2a"
(string).node["opsworks"]["layers"]["
layershortname
"]["instances"]["instancehostname
"]["availability_zone"] - aws_instance_id
-
The EC2 instance ID (string).
node["opsworks"]["layers"]["
layershortname
"]["instances"]["instancehostname
"]["aws_instance_id"] - backends
-
The number of back-end web processes (number). It determines, for example, the number of concurrent connections that HAProxy will forward to a Rails back end. The default value depends on the instance's memory and number of cores.
node["opsworks"]["layers"]["
layershortname
"]["instances"]["instancehostname
"]["backends"] - booted_at
-
The time that the EC2 instance was booted, using the UTC yyyy-mm-dddThh:mm:ss+hh:mm format (string). For example,
"2013-10-01T08:35:22+00:00"
corresponds to 8:35:22 on Oct. 10, 2013, with no time zone offset. For more information, see ISO 8601. node["opsworks"]["layers"]["
layershortname
"]["instances"]["instancehostname
"]["booted_at"] - created_at
-
The time that the EC2 instance was created, using the UTC yyyy-mm-dddThh:mm:ss+hh:mm format (string). For example,
"2013-10-01T08:35:22+00:00"
corresponds to 8:35:22 on Oct. 10, 2013, with no time zone offset. For more information, see ISO 8601. node["opsworks"]["layers"]["
layershortname
"]["instances"]["instancehostname
"]["created_at"] - elastic_ip
-
The Elastic IP address, which is set to null if the instance does not have one (string).
node["opsworks"]["layers"]["
layershortname
"]["instances"]["instancehostname
"]["elastic_ip"] - instance_type
-
The instance type, such as
"c1.medium"
(string).node["opsworks"]["layers"]["
layershortname
"]["instances"]["instancehostname
"]["instance_type"] - ip
-
The public IP address (string).
node["opsworks"]["layers"]["
layershortname
"]["instances"]["instancehostname
"]["ip"] - private_ip
-
The private IP address (string).
node["opsworks"]["layers"]["
layershortname
"]["instances"]["instancehostname
"]["private_ip"] - public_dns_name
-
The public DNS name (string).
node["opsworks"]["layers"]["
layershortname
"]["instances"]["instancehostname
"]["public_dns_name"] - private_dns_name
-
The private DNS name (string).
node["opsworks"]["layers"]["
layershortname
"]["instances"]["instancehostname
"]["private_dns_name"] - region
-
The AWS region, such as
"us-west-2"
(string).node["opsworks"]["layers"]["
layershortname
"]["instances"]["instancehostname
"]["region"] - status
-
The status (string). Possible values are as follows:
-
"requested"
-
"booting"
-
"running_setup"
-
"online"
-
"setup_failed"
-
"start_failed"
-
"terminating"
-
"terminated"
-
"stopped"
-
"connection_lost"
node["opsworks"]["layers"]["
layershortname
"]["instances"]["instancehostname
"]["status"] -
- name
-
The layer's name, which is used to represent the layer in the console (string). It can be user-defined and is not necessarily unique.
node["opsworks"]["layers"]["
layershortname
"]["name"]