:CreateLaunchTemplateVersion

The operation that you want to perform. Set the value to CreateLaunchTemplateVersion.

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

The ID of the launch template. For more information, call the DescribeLaunchTemplates operation. You must specify LaunchTemplateId or LaunchTemplateName to determine 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 that you want to use to create Elastic Compute Service (ECS) instances. You can call the DescribeImages operation to query available images.

The source of the image.

Specifies whether to use the password preset in the image. Valid values:

• true
• false

Default value: false.

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

The ID of the security group to which to assign the instance. Instances in the same security group can access each other.

The ID of the virtual private cloud (VPC).

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

The name of the instance. 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 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:

• Valid values of InternetMaxBandwidthIn if the purchased outbound public bandwidth is less than or equal to 10 Mbit/s: 1 to 10. Default value: 10.
• Valid values of InternetMaxBandwidthIn if the purchased outbound public bandwidth is greater than 10 Mbit/s: 1 to the value of InternetMaxBandwidthOut. Default value: the value of InternetMaxBandwidthOut.

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 (-). The hostname 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. The hostname 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 in which you want to create the instance.

The category of the system disk. Valid values:

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

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

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

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

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 use as the system disk. Valid values:

• PL0 (default): A single ESSD can deliver up to 10000 random read/write IOPS.
• PL1: A single ESSD can deliver up to 50000 random read/write IOPS.
• PL2: A single ESSD can deliver up to 100000 random read/write IOPS.
• PL3: A single ESSD can deliver up to 1000000 random read/write IOPS.

For more information about ESSD performance levels, see ESSDs.

Specifies whether to release the system disk if 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 performance}

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

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

• true
• false

Specifies whether the instance is I/O optimized. Valid values:

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

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 duration of the instance. Unit: month. 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. Valid values:

• PayByBandwidth
• PayByTraffic

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

The network type of the instance. Valid values:

• classic
• vpc

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

The name of the key pair.

• For Windows instances, this parameter is ignored. The value of Password is valid even if KeyPairName is specified.
• By default, the password-based authentication method is disabled for Linux instances.

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 to the nearest minute based on the value of mm.
• The release time must be at least 30 minutes later than the current time.
• The release time must be at most three years from the current time.

The preemption policy for the pay-as-you-go instance. This parameter takes effect only when InstanceChargeType is set to PostPaid. Valid values:

• NoSpot: The instance is a regular pay-as-you-go instance.
• SpotWithPriceLimit: The instance is a preemptible instance with a user-defined maximum hourly price.
• SpotAsPriceGo: The instance is 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. Up to 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 an appropriate protection period based on your business requirements.

The resource group ID.

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

• Active: enables security hardening for the operating system. This value is applicable only to public images.
• Deactive: does not enable security hardening for the operating system.

The private IP address to assign to the instance.

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

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

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

The performance level of the ESSD to use as data disk N. The value of N must be the same as that in DataDisk.N.Category if DataDisk.N.Category is set to cloud_essd. Valid values:

• PL0: A single ESSD can deliver up to 10000 random read/write IOPS.
• PL1 (default): A single ESSD can deliver up to 50000 random read/write IOPS.
• PL2: A single ESSD can deliver up to 100000 random read/write IOPS.
• PL3: A single ESSD can deliver up to 1000000 random read/write IOPS.

For more information about ESSD performance levels, see ESSDs.

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

The ID of the snapshot that you want to use to create data disk N. Valid values of N: 1 to 16. If DataDisk.N.SnapshotId is specified, DataDisk.N.Size is ignored. The data disk is created based on the size of the specified snapshot.

Use snapshots that were created after July 15, 2013. Otherwise, an error is returned and your request is rejected.

The size of data disk N. Valid values of N: 1 to 16. Unit: GiB. Valid values:

• Valid values if DataDisk.N.Category is set to cloud: 5 to 2000.
• Valid values if DataDisk.N.Category is set to cloud_efficiency: 20 to 32768.
• Valid values if DataDisk.N.Category is set to cloud_ssd: 20 to 32768.
• Valid values if DataDisk.N.Category is set to cloud_essd: vary based on the value of DataDisk.N.PerformanceLevel.
  • Valid values if DataDisk.N.PerformanceLevel is set to PL0: 40 to 32768.
  • Valid values if DataDisk.N.PerformanceLevel is set to PL1: 20 to 32768.
  • Valid values if DataDisk.N.PerformanceLevel is set to PL2: 461 to 32768.
  • Valid values if DataDisk.N.PerformanceLevel is set to PL3: 1261 to 32768.

The value of this parameter must be greater than or equal to the size of the snapshot specified by DataDisk.N.SnapshotId.

The name of data disk N. 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 category of data disk N. Valid values:

• cloud: basic disk
• cloud_efficiency: ultra disk
• cloud_ssd: standard SSD
• cloud_auto: ESSD AutoPL disk
• cloud_essd: ESSD

For I/O optimized instances, the default value is cloud_efficiency. For non-I/O optimized instances, the default value is cloud.

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

• true
• false

Default value: true.

Specifies whether to encrypt data disk N.

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 performance}

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

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

• true
• false

The ID of the automatic snapshot policy to apply to data disk N.

The ID of the vSwitch to which you want to connect the secondary ENI. The instance and the secondary ENI must reside in the same zone of the same VPC, but they can be connected to different vSwitches. The value of N in NetworkInterface.N cannot be greater than 1.

The name of the secondary ENI. The value of N in NetworkInterface.N cannot be greater than 1.

The description of the secondary ENI. The description must be 2 to 256 characters in length, and cannot start with http:// or https://. The value of N in NetworkInterface.N cannot be greater than 1.

The ID of the security group to which you want to assign the secondary ENI. The security groups of the secondary ENI and of the instance must belong to the same VPC. The value of N in NetworkInterface.N cannot be greater than 1.

The primary private IP address of the secondary ENI. The value of N in NetworkInterface.N cannot be greater than 1.

The ID of security group N to which you want to assign the secondary ENI. The security group and the secondary ENI must belong to the same VPC. The valid values of N in SecurityGroupIds.N vary based on the maximum number of security groups to which a secondary ENI can belong. For more information, see Limits. The value of N in NetworkInterface.N cannot be greater than 1.

The type of ENI N. Valid values of N: 1 and 2. If the value of N is 1, you can configure a primary ENI or a secondary ENI. If the value of N is 2, you can configure a primary ENI and a secondary ENI.

Valid values:

• Primary
• Secondary

Default value: Secondary.

The communication mode of the primary ENI. Valid values:

• Standard: uses the TCP communication mode.
• HighPerformance: uses the remote direct memory access (RDMA) communication mode with Elastic RDMA Interface (ERI) enabled.

The key of tag N to add to the instance, Elastic Block Storage (EBS) devices, or primary ENI. Valid values of N: 1 to 5. The tag key cannot be an empty string. The tag key can be up to 64 characters in length and cannot start with acs: or aliyun. The tag key cannot contain http:// or https://.

The value of tag N to add to the instance, EBS devices, or primary ENI. Valid values of N: 1 to 5. The tag value can be an empty string. The tag value can be up to 128 characters in length and cannot start with acs: or aliyun. The tag value cannot contain http:// or https://.

The ID of security group N to which you want to assign the instance. The valid values of N vary based on the maximum number of security groups to which an instance can belong. For more information, see 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 determines 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 Burstable instances.
• Unlimited: the unlimited mode. For more information, see the "Unlimited mode" section in Burstable instances.

The version number of the launch template.

The ID of the request.

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

You must specify LaunchTemplateId or LaunchTemplateName to determine a launch template.