CreateLaunchTemplateVersionRequest Class

Container for the parameters to the CreateLaunchTemplateVersion operation. 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 Elastic Compute Cloud User Guide.

Inheritance Hierarchy

System.Object
  Amazon.Runtime.AmazonWebServiceRequest
    Amazon.EC2.AmazonEC2Request
      Amazon.EC2.Model.CreateLaunchTemplateVersionRequest

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

Syntax

public class CreateLaunchTemplateVersionRequest : AmazonEC2Request
         IAmazonWebServiceRequest

The CreateLaunchTemplateVersionRequest type exposes the following members

Constructors

	Name	Description
	CreateLaunchTemplateVersionRequest()

Properties

Name	Type	Description
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.
LaunchTemplateData	Amazon.EC2.Model.RequestLaunchTemplateData	Gets and sets the property LaunchTemplateData. The information for the launch template.
LaunchTemplateId	System.String	Gets and sets the property LaunchTemplateId. The ID of the launch template. You must specify either the launch template ID or the launch template name, but not both.
LaunchTemplateName	System.String	Gets and sets the property LaunchTemplateName. The name of the launch template. You must specify either the launch template ID or the launch template name, but not both.
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`
SourceVersion	System.String	Gets and sets the property SourceVersion. The version of the launch template on which to base the new version. Snapshots applied to the block device mapping are ignored when creating a new version unless they are explicitly included. If you specify this parameter, the new version inherits the launch parameters from the source version. If you specify additional launch parameters for the new version, they overwrite any corresponding launch parameters inherited from the source version. If you omit this parameter, the new version contains only the launch parameters that you specify for the new version.
VersionDescription	System.String	Gets and sets the property VersionDescription. A description for the version of the launch template.

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 Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

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