AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Container for the parameters to the CreateLaunchTemplateVersion operation. Creates a new version of a launch template. You can specify an existing version of launch template from which to base the new version.

Launch template versions are numbered in the order in which they are created. You cannot specify, change, or replace the numbering of launch template versions.

Launch templates are immutable; after you create a launch template, you can't modify it. Instead, you can create a new version of the launch template that includes any changes you require.

For more information, see Modify a launch template (manage launch template versions) in the Amazon Elastic Compute Cloud User Guide.

Inheritance Hierarchy


Namespace: Amazon.EC2.Model
Assembly: AWSSDK.EC2.dll
Version: 3.x.y.z


public class CreateLaunchTemplateVersionRequest : AmazonEC2Request

The CreateLaunchTemplateVersionRequest type exposes the following members



Public Property ClientToken System.String

Gets and sets the property ClientToken.

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring idempotency.

Constraint: Maximum 128 ASCII characters.

Public Property LaunchTemplateData Amazon.EC2.Model.RequestLaunchTemplateData

Gets and sets the property LaunchTemplateData.

The information for the launch template.

Public Property LaunchTemplateId System.String

Gets and sets the property LaunchTemplateId.

The ID of the launch template.

You must specify either the LaunchTemplateId or the LaunchTemplateName, but not both.

Public Property LaunchTemplateName System.String

Gets and sets the property LaunchTemplateName.

The name of the launch template.

You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.

Public Property ResolveAlias System.Boolean

Gets and sets the property ResolveAlias.

If true, and if a Systems Manager parameter is specified for ImageId, the AMI ID is displayed in the response for imageID. For more information, see Use a Systems Manager parameter instead of an AMI ID in the Amazon Elastic Compute Cloud User Guide.

Default: false

Public Property SourceVersion System.String

Gets and sets the property SourceVersion.

The version number of the launch template version on which to base the new version. The new version inherits the same launch parameters as the source version, except for parameters that you specify in LaunchTemplateData. Snapshots applied to the block device mapping are ignored when creating a new version unless they are explicitly included.

Public Property VersionDescription System.String

Gets and sets the property VersionDescription.

A description for the version of the launch template.


This example creates a new launch template version based on version 1 of the specified launch template and specifies a different AMI ID.

To create a launch template version

var client = new AmazonEC2Client();
var response = client.CreateLaunchTemplateVersion(new CreateLaunchTemplateVersionRequest 
    LaunchTemplateData = new RequestLaunchTemplateData { ImageId = "ami-c998b6b2" },
    LaunchTemplateId = "lt-0abcd290751193123",
    SourceVersion = "1",
    VersionDescription = "WebVersion2"

LaunchTemplateVersion launchTemplateVersion = response.LaunchTemplateVersion;


Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5, 4.0, 3.5