CreateLaunchTemplateVersion
Region:
China (Beijing)
Request Parameters
Required
RegionIdThe region ID of th...
LaunchTemplateIdThe ID of the launc...
LaunchTemplateNameThe name of the lau...
VersionDescriptionThe description of ...
ImageIdThe ID of the image...
ImageOwnerAliasThe source of the i...
PasswordInheritSpecifies whether t...
Please select a Boolean value
InstanceTypeThe instance type
SecurityGroupIdThe ID of the secur...
VpcIdThe ID of the virtu...
VSwitchIdThe ID of the vSwit...
InstanceNameThe instance name
DescriptionThe description of ...
InternetMaxBandwidthInThe maximum inbound...
InternetMaxBandwidthOutThe maximum outboun...
HostNameThe hostname of the...
ZoneIdThe ID of the zone ...
SystemDisk.CategoryThe category of the...
SystemDisk.SizeThe size of the sys...
SystemDisk.DiskNameThe name of the sys...
SystemDisk.DescriptionThe description of ...
SystemDisk.IopsThis parameter is n...
SystemDisk.PerformanceLevelThe performance lev...
SystemDisk.DeleteWithInstanceSpecifies whether t...
Please select a Boolean value
SystemDisk.AutoSnapshotPolicyIdThe ID of the autom...
SystemDisk.ProvisionedIopsThe provisioned rea...
SystemDisk.BurstingEnabledSpecifies whether t...
Please select a Boolean value
IoOptimizedSpecifies whether t...
InstanceChargeTypeThe billing method ...
PeriodThe subscription pe...
InternetChargeTypeThe billing method ...
EnableVmOsConfigSpecifies whether t...
Please select a Boolean value
NetworkTypeThe network type of...
UserDataThe user data of th...
KeyPairNameThe name of the key...
RamRoleNameThe name of the ins...
AutoReleaseTimeThe automatic relea...
SpotStrategyThe preemption poli...
SpotPriceLimitThe maximum hourly ...
SpotDurationThe protection peri...
ResourceGroupIdThe ID of the resou...
SecurityEnhancementStrategySpecifies whether t...
PrivateIpAddressThe private IP addr...
Ipv6AddressCountThe number of IPv6 ...
DeploymentSetIdThe ID of the deplo...
DataDiskThe data disks
0Data disk N
PerformanceLevelThe performance lev...
DescriptionThe description of ...
SnapshotIdThe ID of the snaps...
SizeThe size of data di...
DeviceThe mount point of ...
DiskNameThe name of data di...
CategoryThe category of dat...
DeleteWithInstanceSpecifies whether t...
Please select a Boolean value
EncryptedSpecifies whether t...
ProvisionedIopsThe provisioned rea...
BurstingEnabledSpecifies whether t...
Please select a Boolean value
AutoSnapshotPolicyIdThe ID of the autom...
NetworkInterfaceThe information of ...
0The information of ...
VSwitchIdThe ID of the vSwit...
NetworkInterfaceNameThe name of the sec...
DescriptionThe description of ...
SecurityGroupIdThe ID of the secur...
PrimaryIpAddressThe primary private...
SecurityGroupIdsThe IDs of the secu...
0The ID of security ...
InstanceTypeThe type of ENI N
NetworkInterfaceTrafficModeThe communication m...
DeleteOnReleaseSpecifies whether t...
Please select a Boolean value
TagThe tags to add to ...
0Tag N to add to the...
KeyThe key of tag N to...
ValueThe value of tag N ...
SecurityGroupIdsThe ID of security ...
0The ID of security ...
SystemDisk.EncryptedSpecifies whether t...
DeletionProtectionSpecifies whether t...
Please select a Boolean value
CreditSpecificationThe performance mod...
AutoRenewSpecifies whether t...
Please select a Boolean value
AutoRenewPeriodThe auto-renewal pe...
PeriodUnitThe unit of the sub...
HttpEndpointSpecifies whether t...
HttpTokensSpecifies whether t...
HttpPutResponseHopLimitThis parameter is n...
Plugin DownloadLearn more
VS Code Plugin
Before installing the plugin, please install VS CodeBefore installing the plugin, please install VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains Plugin
Before installing the plugin, please install JetBrains IDEBefore installing the plugin, please install JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

Operation Description

Usage notes

If you want to modify the parameters of a launch template version, you can create another version with different parameter settings for the launch template. You can create up to 30 versions for each launch template.

Request Parameters

Field NameField Details
RegionIdstring

The region ID of the command. You can call the DescribeRegions operation to query the most recent list of regions.

Example:cn-hangzhouReference Value Source:
    DescribeRegions
LaunchTemplateIdstring

The ID of the launch template. For more information, call the DescribeLaunchTemplates operation. You must specify LaunchTemplateId or LaunchTemplateName to specify a launch template.

Example:lt-m5eiaupmvm2op9d****Reference Value Source:
    CreateLaunchTemplate
    DescribeLaunchTemplates
    ModifyLaunchTemplateDefaultVersion
LaunchTemplateNamestring

The name of the launch template. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with http:// or https://. The name can contain letters, digits, colons (:), underscores (_), and hyphens (-).

Example:testLaunchTemplateNameReference Value Source:
    CreateLaunchTemplate
    DescribeLaunchTemplates
VersionDescriptionstring

The description of the launch template version. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

Example:testVersionDescription
ImageIdstring

The ID of the image to use to create the Elastic Compute Service (ECS) instance. You can call the DescribeImages operation to query available images.

Example:win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhdReference Value Source:
    ImportImage
    CopyImage
    ExportImage
    CreateImage
    DescribeImages
ImageOwnerAliasstring

The source of the image.View Details...

Example:systemReference Value Source:
    DescribeImages
PasswordInheritboolean

Specifies whether to use the password that is preconfigured in the image. Valid values:View Details...

Example:false
InstanceTypestring

The instance type. For more information, see Overview of instance families. You can also call the DescribeInstanceTypes operation to query the most recent list of instance types.

Example:ecs.g5.largeReference Value Source:
    DescribeInstanceTypes
    CreateInstance
SecurityGroupIdstring

The ID of the security group to which to assign the ECS instance created based on the launch template version. Instances in the same security group can access each other.View Details...

Example:sg-bp15ed6xe1yxeycg****Reference Value Source:
    CreateSecurityGroup
    DescribeSecurityGroups
VpcIdstring

The ID of the virtual private cloud (VPC) in which to create the ECS instance.

Example:vpc-bp12433upq1y5scen****
VSwitchIdstring

The ID of the vSwitch to which to connect the instance. This parameter is required if you specify the VpcId parameter.

Example:vsw-bp1s5fnvk4gn2tws0****
InstanceNamestring

The instance name. The name must be 2 to 128 characters in length and can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-). The default value of this parameter is the InstanceId value.View Details...

Example:k8s-node-[1,4]-alibabacloudReference Value Source:
    DescribeInstances
    ModifyManagedInstance
    DeregisterManagedInstance
Descriptionstring

The description of the instance. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

Example:testDescription
InternetMaxBandwidthIninteger<int32>

The maximum inbound public bandwidth. Unit: Mbit/s. Valid values:View Details...

Example:50
InternetMaxBandwidthOutinteger<int32>

The maximum outbound public bandwidth. Unit: Mbit/s. Valid values: 0 to 100.

Example:5
HostNamestring

The hostname of the instance.View Details...

Example:testHostName
ZoneIdstring

The ID of the zone to which the instance belongs.

Example:cn-hangzhou-gReference Value Source:
    DescribeZones
SystemDisk.Categorystring

The category of the system disk. Valid values:View Details...

Example:cloud_ssd
SystemDisk.Sizeinteger<int32>

The size of the system disk. Unit: GiB. Valid values:View Details...

Example:40
SystemDisk.DiskNamestring

The name of the system disk. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with http:// or https://. The name can contain letters, digits, colons (:), underscores (_), and hyphens (-).

Example:cloud_ssdSystemReference Value Source:
    DescribeDisks
SystemDisk.Descriptionstring

The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

Example:testSystemDiskDescription
SystemDisk.Iopsinteger<int32>
Note This parameter is not publicly available.
Example:30000
SystemDisk.PerformanceLevelstring

The performance level of the ESSD to be used as the system disk. Default value: PL0. Valid values:View Details...

Example:PL0
SystemDisk.DeleteWithInstanceboolean

Specifies whether to release the system disk when the instance is released. Valid values:View Details...

Example:true
SystemDisk.AutoSnapshotPolicyIdstring

The ID of the automatic snapshot policy to apply to the system disk.

Example:sp-bp1dgzpaxwc4load****Reference Value Source:
    DescribeAutoSnapshotPolicyEx
    CreateAutoSnapshotPolicy
SystemDisk.ProvisionedIopsinteger<int64>

The provisioned read/write IOPS of the ESSD AutoPL disk to use as data disk N. Valid values: 0 to min{50,000, 1,000 × Capacity - Baseline IOPS}View Details...

Notice The field type is Long, and the precision may be lost during serialization/deserialization. Please note that the value must not be greater than 9007199254740991.
Example:50000Reference Value Source:
    DescribeDisks
SystemDisk.BurstingEnabledboolean

Specifies whether to enable the performance burst feature. Valid values:View Details...

Example:true
IoOptimizedstring

Specifies whether to create an I/O optimized instance. Valid values:View Details...

Example:optimized
InstanceChargeTypestring

The billing method of the instance. Valid values:View Details...

Example:PrePaidReference Value Source:
    DescribeInstances
Periodinteger<int32>

The subscription period of the instance. Unit: months. This parameter is valid and required only when InstanceChargeType is set to PrePaid. Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, and 60.

Example:1
InternetChargeTypestring

The billing method for network usage. Default value: PayByTraffic. Valid values:View Details...

Example:PayByTraffic
EnableVmOsConfigboolean

Specifies whether to enable the operating system configuration of the instance.

Example:false
NetworkTypestring

The network type of the instance. Valid values:View Details...

Example:vpc
UserDatastring

The user data of the instance. The user data must be encoded in Base64. The maximum size of raw data is 32 KB.

Example:ZWNobyBoZWxsbyBl****Reference Value Source:
    DescribeUserData
KeyPairNamestring

The name of the key pair to bind to the instance.View Details...

Example:testKeyPairNameReference Value Source:
    CreateKeyPair
    DetachKeyPair
    ImportKeyPair
    AttachKeyPair
    DescribeKeyPairs
RamRoleNamestring

The name of the instance Resource Access Management (RAM) role. You can call the ListRoles operation provided by RAM to query the instance RAM roles that you created.

Example:testRamRoleNameReference Value Source:
    AttachInstanceRamRole
    DetachInstanceRamRole
    DescribeInstanceRamRole
AutoReleaseTimestring

The automatic release time of the instance. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.View Details...

Example:2018-01-01T12:05:00Z
SpotStrategystring

The preemption policy for the pay-as-you-go instance. This parameter is valid only when the InstanceChargeType parameter is set to PostPaid. Default value: NoSpot. Valid values:View Details...

Example:NoSpot
SpotPriceLimitnumber<float>

The maximum hourly price of the preemptible instance. A maximum of three decimal places are allowed.

Example:0.97value <= 999999
SpotDurationinteger<int32>

The protection period of the preemptible instance. Unit: hours. Default value: 1. Valid values:View Details...

Example:1
ResourceGroupIdstring

The ID of the resource group to which to assign the instance.

Example:rg-bp67acfmxazb4p****Reference Value Source:
    DescribeSecurityGroups
SecurityEnhancementStrategystring

Specifies whether to enable security hardening for the operating system. Valid values:View Details...

Example:Active
PrivateIpAddressstring

The private IP address to assign to the instance.View Details...

Example:10.1.**.**Reference Value Source:
    AssignPrivateIpAddresses
Ipv6AddressCountinteger<int32>

The number of IPv6 addresses to randomly generate for the primary elastic network interface (ENI). Valid values: 1 to 10.

Example:1
DeploymentSetIdstring

The ID of the deployment set to which to deploy the instance.

Example:ds-bp1brhwhoqinyjd6****Reference Value Source:
    CreateDeploymentSet
    DescribeDeploymentSets
DataDiskarray<object>

The data disks.

Count of Children <= 16
NetworkInterfacearray<object>

The information of the elastic network interfaces (ENIs).

Count of Children <= 8
Tagarray<object>

The tags to add to the ECS instance, disks, and primary elastic network interface (ENI) created based on the launch template version.

Count of Children <= 21
SecurityGroupIdsarray<string>

The ID of security group N to which to assign the instance. The valid values of N depend on the maximum number of security groups to which the instance can belong. For more information, see Quantity limits.View Details...

Example:sg-bp15ed6xe1yxeycg7****Count of Children <= 16
SystemDisk.Encryptedstring

Specifies whether to encrypt the system disk. Valid values:View Details...

Example:falseReference Value Source:
    DescribeDiskEncryptionByDefaultStatus
DeletionProtectionboolean

Specifies whether to enable release protection for the instance. This parameter specifies whether you can use the ECS console or call the DeleteInstance operation to release the instance. Valid values:View Details...

Example:false
CreditSpecificationstring

The performance mode of the burstable instance. Valid values:View Details...

Example:Standard
AutoRenewboolean

Specifies whether to enable auto-renewal for the instance. This parameter is valid only if InstanceChargeType is set to PrePaid. Valid values:View Details...

Example:true
AutoRenewPeriodinteger<int32>

The auto-renewal period of the instance. Valid values:View Details...

Example:1
PeriodUnitstring

The unit of the subscription period. Valid values:View Details...

Example:Month
HttpEndpointstring

Specifies whether to enable the access channel for instance metadata. Valid values:View Details...

Example:enabled
HttpTokensstring

Specifies whether to forcefully use the security hardening mode (IMDSv2) to access instance metadata. Valid values:View Details...

Example:optional
HttpPutResponseHopLimitinteger<int32>
Note This parameter is not publicly available.
Example:3

Response Parameters

Field NameField Details
LaunchTemplateVersionNumberinteger<int64>

The number of the created version of the launch template.

Notice Please note that this value is of type Long, and there may be a risk of loss of precision in some languages. Please use it with caution.
Example:2
RequestIdstring

The request ID.

Example:473469C7-AA6F-4DC5-B3DB-A3DC0DExxxxx
LaunchTemplateIdstring

The ID of the launch template. For more information, see DescribeLaunchTemplates .View Details...

Example:lt-bp1apo0bbbkuy0rj****
Change History