AmazonEC2Client.CreateLaunchTemplateVersion Method (CreateLaunchTemplateVersionRequest)

Creates a new version of a launch template. You must specify an existing launch template, either by name or ID. You can determine whether the new version inherits parameters from a source version, and add or overwrite parameters as needed.

Launch template versions are numbered in the order in which they are created. You can't 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 the changes that you require.

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

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateLaunchTemplateVersionAsync.

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

Syntax

public virtual CreateLaunchTemplateVersionResponse CreateLaunchTemplateVersion(
         CreateLaunchTemplateVersionRequest request
)

Parameters

request: Type: Amazon.EC2.Model.CreateLaunchTemplateVersionRequest

Container for the necessary parameters to execute the CreateLaunchTemplateVersion service method.

Return Value

Type: CreateLaunchTemplateVersionResponse

The response from the CreateLaunchTemplateVersion service method, as returned by EC2.

Examples

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 Framework:
Supported in: 4.5 and newer, 3.5

AmazonEC2Client.CreateLaunchTemplateVersion (CreateLaunchTemplateVersionRequest)