Elastic Compute Service:CreateLaunchTemplateVersion

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

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

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 (-).

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

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.

The source of the image.

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

• true
• false

Default value: false.

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.

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.

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

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

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.

When you create multiple ECS instances at a time, you can batch configure sequential names for the instances. The instance names can contain square brackets ([]) and commas (,). For more information, see Batch configure sequential names or hostnames for multiple instances.

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

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

• When the purchased outbound public bandwidth is less than or equal to 10 Mbit/s, the valid values of this parameter are 1 to 10 and the default value is 10.
• If the purchased outbound public bandwidth is greater than 10 Mbit/s, the valid values of this parameter range from 1 to the InternetMaxBandwidthOut value and the default value is the InternetMaxBandwidthOut value.

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

The hostname of the instance.

• The hostname cannot start or end with a period (.) or hyphen (-). It cannot contain consecutive periods (.) or hyphens (-).
• For Windows instances, the hostname must be 2 to 15 characters in length and cannot contain periods (.) or contain only digits. It can contain letters, digits, and hyphens (-).
• For instances that run other operating systems such as Linux, the hostname must be 2 to 64 characters in length. You can use periods (.) to separate the hostname into multiple segments. Each segment can contain letters, digits, and hyphens (-).

The ID of the zone to which the instance belongs.

The category of the system disk. Valid values:

• cloud: basic disk.
• cloud_efficiency: ultra disk.
• cloud_ssd: standard SSD.
• cloud_auto: Enterprise SSD (ESSD) AutoPL disk.
• cloud_essd: ESSD. You can use SystemDisk.PerformanceLevel to set the performance level of the ESSD to use as the system disk.
• cloud_essd_entry: ESSD Entry disk.

For non-I/O optimized instances of retired instance types, the default value is cloud. For other types of instances, the default value is cloud_efficiency.

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

• Valid values if you set SystemDisk.Category to cloud: 20 to 500.
• Valid values if you set SystemDisk.Category to other disk categories: 20 to 2048.

The value of this parameter must be at least 20 and greater than or equal to the size of the image.

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 (-).

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

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

• PL0: A single ESSD can deliver up to 10,000 random read/write IOPS.
• PL1: A single ESSD can deliver up to 50,000 random read/write IOPS.
• PL2: A single ESSD can deliver up to 100,000 random read/write IOPS.
• PL3: A single ESSD can deliver up to 1,000,000 random read/write IOPS.

For more information about ESSD performance levels, see ESSDs .

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

• true
• false

Default value: true.

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

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}

Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}

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

• true: encrypts the disk.
• false: does not enable the performance burst feature.

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

• none: The instance is not I/O optimized.
• optimized: creates an I/O optimized instance.

The billing method of the instance. Valid values:

• PrePaid: subscription. If you set this parameter to PrePaid, make sure that your account has sufficient credits. Otherwise, an InvalidPayMethod error is returned.
• PostPaid: pay-as-you-go

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.

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

• PayByBandwidth: pay-by-bandwidth
• PayByTraffic: pay-by-traffic

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

The network type of the instance. Valid values:

• classic: classic network
• vpc: VPC

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

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

• For Windows instances, this parameter is ignored The Password parameter is valid even if the KeyPairName parameter is specified.
• For Linux instances, the password-based logon method is disabled by default.

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.

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.

• If the value of ss is not 00, the time is automatically rounded down to the nearest minute based on the value of mm.
• The specified time must be at least 30 minutes later than the current time.
• The specified time can be at most three years later than the current time.

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:

• NoSpot: The instance is created as a pay-as-you-go instance.
• SpotWithPriceLimit: The instances of the compute node are preemptible instances. These types of instances have a specified maximum hourly price.
• SpotAsPriceGo: The instance is created as a preemptible instance for which the market price at the time of purchase is automatically used as the bid price.

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

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

• 1: After a preemptible instance is created, Alibaba Cloud ensures that the instance is not automatically released within 1 hour. After the 1-hour protection period ends, the system compares the bid price with the market price and checks the resource inventory to determine whether to retain or release the instance.
• 0: After a preemptible instance is created, Alibaba Cloud does not ensure that the instance runs for 1 hour. The system compares the bid price with the market price and checks the resource inventory to determine whether to retain or release the instance.

Alibaba Cloud sends an ECS system event to notify you 5 minutes before the instance is released. Preemptible instances are billed by second. We recommend that you specify a protection period based on your business requirements.

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

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

• Active: Security hardening is enabled. This value is applicable only to public images.
• Deactive: Security hardening is disabled. This value is available to all types of images.

The private IP address to assign to the instance.

To assign a private IP address to an instance of the VPC type, make sure that the IP address is an idle IP address within the CIDR block of the vSwitch specified by the VSwitchId parameter.

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

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

The data disks.

The information of the elastic network interfaces (ENIs).

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

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.

Specifies whether to encrypt the system disk. Valid values:

• true
• false

Default value: false

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:

• true
• false

Default value: false.

The performance mode of the burstable instance. Valid values:

• Standard: the standard mode. For more information, see the "Standard mode" section in Overview of burstable instances.
• Unlimited: the unlimited mode. For more information, see the "Unlimited mode" section in Overview of burstable instances.

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

• true
• false

Default value: false.

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

Valid values when PeriodUnit is set to Month: 1, 2, 3, 6, 12, 24, 36, 48, and 60.

Default value: 1.

The unit of the subscription period. Valid values:

Month (default)

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

• enabled
• disabled

Default value: enabled.

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

• optional: does not forcefully use the security hardening mode (IMDSv2).
• required: forcefully uses the security hardening mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode.

Default value: optional.