
clone-stack
***********


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

Creates a clone of a specified stack.


SYNOPSIS
========

   aws opsworks clone-stack
     [--service-role-arn <value>]
     [--name <value>]
     [--hostname-theme <value>]
     [--use-custom-cookbooks ]
     [--default-availability-zone <value>]
     [--stack-region <value>]
     [--source-stack-id <value>]
     [--custom-cookbooks-source <value>]
     [--default-ssh-key-name <value>]
     [--clone-app-ids <value>]
     [--clone-permissions ]
     [--default-instance-profile-arn <value>]
     [--attributes <value>]
     [--custom-json <value>]
     [--default-os <value>]


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

None


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

"--service-role-arn"  (string)
   The stack AWS Identity and Access Management (IAM) role, which
   allows OpsWorks to work with AWS resources on your behalf. You must
   set this parameter to the Amazon Resource --name (ARN) for an
   existing IAM role. If you create a stack by using the OpsWorks
   console, it creates the role for you. You can obtain an existing
   stack's IAM ARN programmatically by calling  describe-permissions .
   For more information about IAM ARNs, see Using Identifiers .

"--name"  (string)
   The cloned stack name.

"--hostname-theme"  (string)
   The cloned stack host name theme, with spaces replaced by
   underscores. For example: Bud_Spencer. OpsWorks uses this string to
   generate host names for the stack instances.

"--use-custom-cookbooks"  (boolean)
   Whether to use custom cookbooks.

"--default-availability-zone"  (string)
   The cloned stack Availability Zone. For more information, see
   Regions and Endpoints .

"--stack-region"  (string)
   The cloned stack AWS region, such as "us-east-1". For more
   information about AWS regions, see Regions and Endpoints

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

"--custom-cookbooks-source"  (structure)
   "username"  (string)
      The user name.

   "ssh_key"  (string)
      The repository's SSH key.

   "url"  (string)
      The source URI. For example, the source URI for the OpsWorks
      MySQL cookbook is: "https://github.com/scalarium/cookbooks.git"

      For Github repositories, you can also use the "git://..."
      format. For example: "git://github.com/scalarium/cookbooks.git"

   "password"  (string)
      The repository's password.

   "type"  (string)
      The repository type.

   "revision"  (string)
      The application's version. OpsWorks enables you to easily deploy
      new versions of an application. One of the simplest approaches
      is to have branches or revisions in your repository that
      represent different versions that can potentially be deployed.

   *Parameter Syntax*

      {
        "username": "string",
        "ssh_key": "string",
        "url": "string",
        "password": "string",
        "type": "git"|"svn"|"archive"|"s3",
        "revision": "string"
      }

"--default-ssh-key-name"  (string)
   A default SSH key for the stack instances. You can override this
   value when you create or update an instance.

"--clone-app-ids"  (list of string)
   A list of source stack app IDs to be included in the cloned stack.

   *Parameter Syntax*

      ["string", ...]

"--clone-permissions"  (boolean)
   Whether to clone the source stack's permissions.

"--default-instance-profile-arn"  (string)
   TBD

"--attributes"  (map)
   A list of stack attributes and values as key/value pairs to be
   added to the cloned stack.

   *Parameter Syntax*

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

"--custom-json"  (string)
   A string that contains user-defined, custom JSON. It is used to
   override the corresponding default stack configuration JSON values.
   The string should be in the following format and must escape
   characters such as '"'.: ""{\"key1\": \"value1\", \"key2\":
   \"value2\",...}""

"--default-os"  (string)
   The cloned stack default operating system, which must be one of the
   following:

   * m1.small

   * m1.medium

   * m1.large

   * m1.xlarge

   * c1.medium

   * c1.xlarge

   * m2.xlarge

   * m2.2xlarge

   * m2.4xlarge
