
update-stack
************


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

Updates a stack as specified in the template. After the call completes
successfully, the stack update starts. You can check the status of the
stack via the  describe-stacks action.

To get a copy of the template for an existing stack, you can use the
get-template action.

Tags that were associated with this stack during creation time will
still be associated with the stack after an "update-stack" operation.

For more information about creating an update template, updating a
stack, and monitoring the progress of the update, see Updating a Stack
.


SYNOPSIS
========

   aws cloudformation update-stack
     --stack-name <value>
     [--template-url <value>]
     [--parameters <value>]
     [--template-body <value>]
     [--capabilities <value>]


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

"--stack-name"  (string)
   The name or stack ID of the stack to update.

   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-url"  (string)
   Location of file containing the template body. The URL must point
   to a template 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.

"--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"
        }
        ...
      ]

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

"--capabilities"  (list of string)
   The list of capabilities that you want to allow in the stack. If
   your stack 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", ...]
