[ aws . proton ]

create-environment-template-version

Description

Create a new major or minor version of an environment template. A major version of an environment template is a version that isn’t backwards compatible. A minor version of an environment template is a version that’s backwards compatible within its major version.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  create-environment-template-version
[--client-token <value>]
[--description <value>]
[--major-version <value>]
--source <value>
[--tags <value>]
--template-name <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--client-token (string)

When included, if two identical requests are made with the same client token, Proton returns the environment template version that the first request created.

--description (string)

A description of the new version of an environment template.

--major-version (string)

To create a new minor version of the environment template, include major Version .

To create a new major and minor version of the environment template, exclude major Version .

--source (structure)

An object that includes the template bundle S3 bucket path and name for the new version of an template.

s3 -> (structure)

An S3 source object that includes the template bundle S3 path and name for a template minor version.

bucket -> (string)

The name of the S3 bucket that contains a template bundle.

key -> (string)

The path to the S3 bucket that contains a template bundle.

Shorthand Syntax:

s3={bucket=string,key=string}

JSON Syntax:

{
  "s3": {
    "bucket": "string",
    "key": "string"
  }
}

--tags (list)

An optional list of metadata items that you can associate with the Proton environment template version. A tag is a key-value pair.

For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide .

(structure)

A description of a resource tag.

key -> (string)

The key of the resource tag.

value -> (string)

The value of the resource tag.

Shorthand Syntax:

key=string,value=string ...

JSON Syntax:

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

--template-name (string)

The name of the environment template.

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Output

environmentTemplateVersion -> (structure)

The environment template detail data that’s returned by Proton.

arn -> (string)

The Amazon Resource Name (ARN) of the version of an environment template.

createdAt -> (timestamp)

The time when the version of an environment template was created.

description -> (string)

A description of the minor version of an environment template.

lastModifiedAt -> (timestamp)

The time when the version of an environment template was last modified.

majorVersion -> (string)

The latest major version that’s associated with the version of an environment template.

minorVersion -> (string)

The minor version of an environment template.

recommendedMinorVersion -> (string)

The recommended minor version of the environment template.

schema -> (string)

The schema of the version of an environment template.

status -> (string)

The status of the version of an environment template.

statusMessage -> (string)

The status message of the version of an environment template.

templateName -> (string)

The name of the version of an environment template.