layers Attributes - AWS OpsWorks

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 as php-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"]