
create-application-version
**************************


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

Creates an application version for the specified application.

Note: Once you create an application version with a specified Amazon S3
  bucket and key location, you cannot change that Amazon S3 location.
  If you change the Amazon S3 location, you receive an exception when
  you attempt to launch an environment from the application version.


SYNOPSIS
========

   aws elasticbeanstalk create-application-version
     --application-name <value>
     --version-label <value>
     [--auto-create-application ]
     [--source-bundle <value>]
     [--description <value>]


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

"--application-name"  (string)
   The name of the application. If no application is found with this
   name, and "--auto-create-application" is "false" , returns an
   "InvalidParameterValue" error.

"--version-label"  (string)
   A label identifying this version.

   Constraint: Must be unique per application. If an application
   version already exists with this label for the specified
   application, AWS Elastic Beanstalk returns an
   "InvalidParameterValue" error.


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

"--auto-create-application"  (boolean)
   Determines how the system behaves if the specified application for
   this version does not already exist:

   "true" : Automatically creates the specified application for this
   version if it does not already exist.

   "false" : Returns an "InvalidParameterValue" if the specified
   application for this version does not already exist.

   * "true" : Automatically creates the specified application for this
     release if it does not already exist.

   * "false" : Throws an "InvalidParameterValue" if the specified
     application for this release does not already exist.

   Default: "false"

   Valid Values: "true" | "false"

"--source-bundle"  (structure)
   The Amazon S3 bucket and key that identify the location of the
   source bundle for this version.

   If data found at the Amazon S3 location exceeds the maximum allowed
   source bundle size, AWS Elastic Beanstalk returns an
   "InvalidParameterValue" error.

   Default: If not specified, AWS Elastic Beanstalk uses a sample
   application. If only partially specified (for example, a bucket is
   provided but not the key) or if no data is found at the Amazon S3
   location, AWS Elastic Beanstalk returns an
   "InvalidParameterCombination" error.

   "s3_bucket"  (string)
      The Amazon S3 bucket where the data is located.

   "s3_key"  (string)
      The Amazon S3 key where the data is located.

   *Parameter Syntax*

      {
        "s3_bucket": "string",
        "s3_key": "string"
      }

"--description"  (string)
   Describes this version.
