[ aws . proton ]

create-service-template-version

Description

Create a new major or minor version of a service template. A major version of a service template is a version that isn’t backwards compatible. A minor version of a service 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-service-template-version
[--client-token <value>]
--compatible-environment-templates <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 identicial requests are made with the same client token, AWS Proton returns the service template version that the first request created.

--compatible-environment-templates (list)

An array of compatible environment template objects for the new version of a service template.

(structure)

Compatible environment template data.

majorVersion -> (string)

The major version of the compatible environment template.

templateName -> (string)

The compatible environment template name.

Shorthand Syntax:

majorVersion=string,templateName=string ...

JSON Syntax:

[
  {
    "majorVersion": "string",
    "templateName": "string"
  }
  ...
]

--description (string)

A description of the new version of a service template.

--major-version (string)

To create a new minor version of the service template, include a majorVersion .

To create a new major and minor version of the service template, exclude majorVersion .

--source (structure)

An object that includes the template bundle S3 bucket path and name for the new version of a service 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)

Create tags for a new version of a service template.

(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 service 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

serviceTemplateVersion -> (structure)

The service template version summary of detail data that’s returned by AWS Proton.

arn -> (string)

The Amazon Resource Name (ARN) of the version of a service template.

compatibleEnvironmentTemplates -> (list)

An array of compatible environment template names for the major version of a service template.

(structure)

Compatible environment template data.

majorVersion -> (string)

The major version of the compatible environment template.

templateName -> (string)

The compatible environment template name.

createdAt -> (timestamp)

The time when the version of a service template was created.

description -> (string)

A description of the version of a service template.

lastModifiedAt -> (timestamp)

The time when the version of a service template was last modified.

majorVersion -> (string)

The ID of the latest major version that’s associated with the version of a service template.

minorVersion -> (string)

The ID of the minor version of a service template.

recommendedMinorVersion -> (string)

The ID of the recommended minor version of the service template.

schema -> (string)

The schema of the version of a service template.

status -> (string)

The service template version status.

statusMessage -> (string)

A service template version status message.

templateName -> (string)

The name of the version of a service template.