
create-configuration-template
*****************************


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

Creates a configuration template. Templates are associated with a
specific application and are used to deploy different versions of the
application with the same configuration settings.

Related Topics

* describe-configuration-options

* describe-configuration-settings

* list-available-solution-stacks


SYNOPSIS
========

   aws elasticbeanstalk create-configuration-template
     --application-name <value>
     --template-name <value>
     [--source-configuration <value>]
     [--description <value>]
     [--environment-id <value>]
     [--solution-stack-name <value>]
     [--option-settings <value>]


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

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

"--template-name"  (string)
   The name of the configuration template.

   Constraint: This name must be unique per application.

   Default: If a configuration template already exists with this name,
   AWS Elastic Beanstalk returns an "InvalidParameterValue" error.


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

"--source-configuration"  (structure)
   If specified, AWS Elastic Beanstalk uses the configuration values
   from the specified configuration template to create a new
   configuration.

   Values specified in the "--option-settings" parameter of this call
   overrides any values obtained from the "--source-configuration" .

   If no configuration template is found, returns an
   "InvalidParameterValue" error.

   Constraint: If both the solution stack name parameter and the
   source configuration parameters are specified, the solution stack
   of the source configuration template must match the specified
   solution stack name or else AWS Elastic Beanstalk returns an
   "InvalidParameterCombination" error.

   "application_name"  (string)
      The name of the application associated with the configuration.

   "template_name"  (string)
      The name of the configuration template.

   *Parameter Syntax*

      {
        "application_name": "string",
        "template_name": "string"
      }

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

"--environment-id"  (string)
   The ID of the environment used with this configuration template.

"--solution-stack-name"  (string)
   The name of the solution stack used by this configuration. The
   solution stack specifies the operating system, architecture, and
   application server for a configuration template. It determines the
   set of configuration options as well as the possible and default
   values.

   Use  list-available-solution-stacks to obtain a list of available
   solution stacks.

   Default: If the "--solution-stack-name" is not specified and the
   source configuration parameter is blank, AWS Elastic Beanstalk uses
   the default solution stack.

   If not specified and the source configuration parameter is
   specified, AWS Elastic Beanstalk uses the same solution stack as
   the source configuration template.

"--option-settings"  (list)
   If specified, AWS Elastic Beanstalk sets the specified
   configuration option to the requested value. The new value
   overrides the value obtained from the solution stack or the source
   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"
        }
        ...
      ]
