DescribeLaunchTemplateVersions#

Description#

Request to receive information about one or more versions. To request the description of all versions, specific versions, or a range of versions of a particular launch template, specify LaunchTemplateId or LaunchTemplateName. To get description of the latest and/or default versions for all launch templates, specify $Latest and/or $Default in LaunchTemplateVersion.N.

Request Parameters#

Required parameters#

  • LaunchTemplateId — The ID of the launch template.

    • Type: String

    • Required: Yes, when requesting versions of a specific launch template

    • Constraints: Cannot be used with the LaunchTemplateName option

  • LaunchTemplateName — The name of the launch template.

    • Type: String

    • Required: Yes, when requesting versions of a specific launch template

    • Constraints: Cannot be used with the LaunchTemplateId option

    • Length constraints: from 3 to 255 characters

  • LaunchTemplateVersion.N — The launch template versions.

    • Type: Array of strings

    • Required: Yes, if neither LaunchTemplateId nor LaunchTemplateName is specified

    • Valid values: Version number, $Default or``$Latest``

Optional parameters#

  • Filter.N — One or more filters.

    • Type: Filter object

    • Required: No

  • MaxVersion — The version number corresponding to the upper limit of version range for which the description is requested.

    • Type: String

    • Required: No

    • Constraints: Cannot be used with the LaunchTemplateVersion.N option

  • MinVersion — The version number corresponding to the lower limit of version range for which the description is requested.

    • Type: String

    • Required: No

    • Constraints: Cannot be used with the LaunchTemplateVersion.N option

Supported Filters#

  • create-time — The time at which the launch template was created.

  • image-id — The image ID.

  • instance-type — The type of the instance.

  • is-default-version — Indicates whether it is the default version of the launch template.

Response Elements#

  • launchTemplateVersionSet — Information about the versions of the launch template.

  • requestId — The request ID.

    • Type: String

Examples#

c2-ec2 DescribeLaunchTemplateVersions LaunchTemplateName test

c2-ec2 DescribeLaunchTemplateVersions LaunchTemplateName test LaunchTemplateVersion.0 1

c2-ec2 DescribeLaunchTemplateVersions LaunchTemplateName test LaunchTemplateVersion.0 '$Default'

c2-ec2 DescribeLaunchTemplateVersions LaunchTemplateName test MinVersion 1 MaxVersion 3

c2-ec2 DescribeLaunchTemplateVersions LaunchTemplateVersion.0 '$Latest'