Menu
AWS OpsWorks
User Guide (API Version 2013-02-18)

layers Attributes

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

Copy
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).

Copy
node["opsworks"]["layers"]["layershortname"]["instances"]["instancehostname"]["availability_zone"]
aws_instance_id

The EC2 instance ID (string).

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

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

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

Copy
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).

Copy
node["opsworks"]["layers"]["layershortname"]["instances"]["instancehostname"]["elastic_ip"]
instance_type

The instance type, such as "c1.medium" (string).

Copy
node["opsworks"]["layers"]["layershortname"]["instances"]["instancehostname"]["instance_type"]
ip

The public IP address (string).

Copy
node["opsworks"]["layers"]["layershortname"]["instances"]["instancehostname"]["ip"]
private_ip

The private IP address (string).

Copy
node["opsworks"]["layers"]["layershortname"]["instances"]["instancehostname"]["private_ip"]
public_dns_name

The public DNS name (string).

Copy
node["opsworks"]["layers"]["layershortname"]["instances"]["instancehostname"]["public_dns_name"]
private_dns_name

The private DNS name (string).

Copy
node["opsworks"]["layers"]["layershortname"]["instances"]["instancehostname"]["private_dns_name"]
region

The AWS region, such as "us-west-2" (string).

Copy
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"

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

Copy
node["opsworks"]["layers"]["layershortname"]["name"]