
create-environment
******************


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

Launches an environment for the specified application using the
specified configuration.


SYNOPSIS
========

   aws elasticbeanstalk create-environment
     --application-name <value>
     --environment-name <value>
     [--version-label <value>]
     [--description <value>]
     [--template-name <value>]
     [--cname-prefix <value>]
     [--solution-stack-name <value>]
     [--option-settings <value>]
     [--options-to-remove <value>]


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

"--application-name"  (string)
   The name of the application that contains the version to be
   deployed.

   If no application is found with this name, "create-environment"
   returns an "InvalidParameterValue" error.

"--environment-name"  (string)
   A unique name for the deployment environment. Used in the
   application URL.

   Constraint: Must be from 4 to 23 characters in length. The name can
   contain only letters, numbers, and hyphens. It cannot start or end
   with a hyphen. This name must be unique in your account. If the
   specified name already exists, AWS Elastic Beanstalk returns an
   "InvalidParameterValue" error.

   Default: If the CNAME parameter is not specified, the environment
   name becomes part of the CNAME, and therefore part of the visible
   URL for your application.


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

"--version-label"  (string)
   The name of the application version to deploy.

   If the specified application has no associated application
   versions, AWS Elastic Beanstalk "update-environment" returns an
   "InvalidParameterValue" error.

   Default: If not specified, AWS Elastic Beanstalk attempts to launch
   the most recently created application version.

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

"--template-name"  (string)
   The name of the configuration template to use in deployment. If no
   configuration template is found with this name, AWS Elastic
   Beanstalk returns an "InvalidParameterValue" error.

   Condition: You must specify either this parameter or a "--solution-
   stack-name" , but not both. If you specify both, AWS Elastic
   Beanstalk returns an "InvalidParameterCombination" error. If you do
   not specify either, AWS Elastic Beanstalk returns a
   "MissingRequiredParameter" error.

"--cname-prefix"  (string)
   If specified, the environment attempts to use this value as the
   prefix for the CNAME. If not specified, the environment uses the
   environment name.

"--solution-stack-name"  (string)
   This is an alternative to specifying a configuration name. If
   specified, AWS Elastic Beanstalk sets the configuration values to
   the default values associated with the specified solution stack.

   Condition: You must specify either this or a "--template-name" ,
   but not both. If you specify both, AWS Elastic Beanstalk returns an
   "InvalidParameterCombination" error. If you do not specify either,
   AWS Elastic Beanstalk returns a "MissingRequiredParameter" error.

"--option-settings"  (list)
   If specified, AWS Elastic Beanstalk sets the specified
   configuration options to the requested value in the configuration
   set for the new environment. These override the values obtained
   from the solution stack or the configuration template.

      (structure)
         A specification identifying an individual configuration
         option along with its current value.

         "option_name"  (string)
            The name of the configuration option.

         "namespace"  (string)
            A unique namespace identifying the option's associated AWS
            resource.

         "value"  (string)
            The current value for the configuration option.

   *Parameter Syntax*

      [
        {
          "option_name": "string",
          "namespace": "string",
          "value": "string"
        }
        ...
      ]

"--options-to-remove"  (list)
   A list of custom user-defined configuration options to remove from
   the configuration set for this new environment.

      (structure)
         A specification identifying an individual configuration
         option.

         "option_name"  (string)
            The name of the configuration option.

         "namespace"  (string)
            A unique namespace identifying the option's associated AWS
            resource.

   *Parameter Syntax*

      [
        {
          "option_name": "string",
          "namespace": "string"
        }
        ...
      ]
