
create-layer
************


DESCRIPTION
===========

Creates a layer.


SYNOPSIS
========

   aws opsworks create-layer
     --stack-id <value>
     --name <value>
     --shortname <value>
     --type <value>
     [--auto-assign-elastic-ips ]
     [--custom-security-group-ids <value>]
     [--custom-recipes <value>]
     [--enable-auto-healing ]
     [--custom-instance-profile-arn <value>]
     [--volume-configurations <value>]
     [--attributes <value>]
     [--packages <value>]


REQUIRED PARAMETERS
===================

"--stack-id"  (string)
   The layer stack ID.

"--name"  (string)
   The layer name, which is used by the console.

"--shortname"  (string)
   The layer short name, which is used internally by OpsWorks and by
   Chef recipes. The shortname is also used as the name for the
   directory where your app files are installed. It can have a maximum
   of 200 characters, which are limited to the alphanumeric
   characters, '-', '_', and '.'.

"--type"  (string)
   The layer type. A stack cannot have more than one layer of the same
   type.


OPTIONAL PARAMETERS
===================

"--auto-assign-elastic-ips"  (boolean)
   Whether to automatically assign an Elastic IP address to the layer.

"--custom-security-group-ids"  (list of string)
   An array containing the layer custom security group IDs.

   *Parameter Syntax*

      ["string", ...]

"--custom-recipes"  (structure)
   A "LayerCustomRecipes" object that specifies the layer custom
   recipes.

   "undeploy"  (list of string)
      An array of custom recipe names to be run following a "undeploy"
      event.

   "setup"  (list of string)
      An array of custom recipe names to be run following a "setup"
      event.

   "configure"  (list of string)
      An array of custom recipe names to be run following a
      "configure" event.

   "shutdown"  (list of string)
      An array of custom recipe names to be run following a "shutdown"
      event.

   "deploy"  (list of string)
      An array of custom recipe names to be run following a "deploy"
      event.

   *Parameter Syntax*

      {
        "undeploy":
          ["string", ...],
        "setup":
          ["string", ...],
        "configure":
          ["string", ...],
        "shutdown":
          ["string", ...],
        "deploy":
          ["string", ...]
      }

"--enable-auto-healing"  (boolean)
   Whether to disable auto healing for the layer.

"--custom-instance-profile-arn"  (string)
   The ARN of an IAM profile that to be used for the layer's EC2
   instances. For more information about IAM ARNs, see Using
   Identifiers .

"--volume-configurations"  (list)
   A "--volume-configurations" object that describes the layer Amazon
   EBS volumes.

      (structure)
         Describes an Amazon EBS volume configuration.

         "size"  (integer)
            The volume size.

         "mount_point"  (string)
            The volume mount point. For example "/dev/sdh".

         "raid_level"  (integer)
            The volume RAID level .

         "number_of_disks"  (integer)
            The number of disks in the volume.

   *Parameter Syntax*

      [
        {
          "size": integer,
          "mount_point": "string",
          "raid_level": integer,
          "number_of_disks": integer
        }
        ...
      ]

"--attributes"  (map)
   One or more user-defined key/value pairs to be added to the stack
   attributes bag.

   *Parameter Syntax*

      {
        "string": "string"
        ...
      }

"--packages"  (list of string)
   An array of "Package" objects that describe the layer packages.

   *Parameter Syntax*

      ["string", ...]
