
create-stack
************


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

Creates a stack as specified in the template. After the call completes
successfully, the stack creation starts. You can check the status of
the stack via the  describe-stacks API.

Note: Currently, the limit for stacks is 20 stacks per account per region.


SYNOPSIS
========

   aws cloudformation create-stack
     --stack-name <value>
     [--template-body <value>]
     [--parameters <value>]
     [--tags <value>]
     [--timeout-in-minutes <value>]
     [--capabilities <value>]
     [--notification-ar-ns <value>]
     [--on-failure <value>]
     [--disable-rollback ]
     [--template-url <value>]


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

"--stack-name"  (string)
   The name associated with the stack. The name must be unique within
   your AWS account.

   Note: Must contain only alphanumeric characters (case sensitive) and
     start with an alpha character. Maximum length of the name is 255
     characters.


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

"--template-body"  (string)
   Structure containing the template body. (For more information, go
   to the AWS CloudFormation User Guide .)

   Conditional: You must pass "--template-body" or "--template-url" .
   If both are passed, only "--template-body" is used.

"--parameters"  (list)
   A list of "Parameter" structures that specify input parameters for
   the stack.

      (structure)
         The Parameter data type.

         "parameter_value"  (string)
            The value associated with the parameter.

         "parameter_key"  (string)
            The key associated with the parameter.

   *Parameter Syntax*

      [
        {
          "parameter_value": "string",
          "parameter_key": "string"
        }
        ...
      ]

"--tags"  (list)
   A set of user-defined "--tags" to associate with this stack,
   represented by key/value pairs. --tags defined for the stack are
   propogated to EC2 resources that are created as part of the stack.
   A maximum number of 10 tags can be specified.

      (structure)
         The Tag type is used by "create-stack" in the "--tags"
         parameter. It allows you to specify a key/value pair that can
         be used to store information related to cost allocation for
         an AWS CloudFormation stack.

         "value"  (string)
            *Required* . A string containing the value for this tag.
            You can specify a maximum of 256 characters for a tag
            value.

         "key"  (string)
            *Required* . A string used to identify this tag. You can
            specify a maximum of 128 characters for a tag key. --tags
            owned by Amazon Web Services (AWS) have the reserved
            prefix: "aws:" .

   *Parameter Syntax*

      [
        {
          "value": "string",
          "key": "string"
        }
        ...
      ]

"--timeout-in-minutes"  (integer)
   The amount of time that can pass before the stack status becomes
   CREATE_FAILED; if "--disable-rollback" is not set or is set to
   "false" , the stack will be rolled back.

"--capabilities"  (list of string)
   The list of capabilities that you want to allow in the stack. If
   your template contains IAM resources, you must specify the
   CAPABILITY_IAM value for this parameter; otherwise, this action
   returns an InsufficientCapabilities error. IAM resources are the
   following: AWS::IAM::AccessKey , AWS::IAM::Group , AWS::IAM::Policy
   , AWS::IAM::User , and AWS::IAM::UserToGroupAddition .

   *Parameter Syntax*

      ["CAPABILITY_IAM", ...]

"--notification-ar-ns"  (list of string)
   The Simple Notification Service (SNS) topic ARNs to publish stack
   related events. You can find your SNS topic ARNs using the SNS
   console or your Command Line Interface (CLI).

   *Parameter Syntax*

      ["string", ...]

"--on-failure"  (string)
   Determines what action will be taken if stack creation fails. This
   must be one of: DO_NOTHING, ROLLBACK, or DELETE. You can specify
   either "--on-failure" or "--disable-rollback" , but not both.

   Default: "ROLLBACK"

"--disable-rollback"  (boolean)
   Set to "true" to disable rollback of the stack if stack creation
   failed. You can specify either "--disable-rollback" or "--on-
   failure" , but not both.

   Default: "false"

"--template-url"  (string)
   Location of file containing the template body. The URL must point
   to a template (max size: 307,200 bytes) located in an S3 bucket in
   the same region as the stack. For more information, go to the AWS
   CloudFormation User Guide .

   Conditional: You must pass "--template-url" or "--template-body" .
   If both are passed, only "--template-body" is used.
