Elastic Compute Service:CreateLaunchTemplate

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

The tags to add to the 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 instance. You can call the DescribeImages operation to query available images.

The source of the image. Valid values:

• system: public image provided by Alibaba Cloud.
• self: custom image that you created.
• others: shared image from another Alibaba Cloud account.
• marketplace:Alibaba Cloud Marketplace image. If Alibaba Cloud Marketplace images are available, you can use the images without the need to subscribe to the images. Take note of the billing details of Alibaba Cloud Marketplace images.

Specifies whether to use the preset password of the image.

The instance type of the instance. For more information, see Instance families. Alternatively, you can 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 communicate with each other. A security group can contain up to 1,000 instances.

The ID of the virtual private cloud (VPC).

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 instance description. 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.
• When the purchased outbound public bandwidth is greater than 10 Mbit/s, the valid values of this parameter are 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 instance hostname.

• 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 in which to create the instance.

The category of the system disk. Valid values:

• cloud: basic disk.
• cloud_efficiency: ultra disk.
• cloud_ssd: standard SSD.
• cloud_essd: Enterprise SSD (ESSD). You can use SystemDisk.PerformanceLevel to set the performance level of the ESSD to use as the system disk.
• cloud_auto: ESSD AutoPL 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 use 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 the system disk. 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 for the system disk. Valid values:

• true
• false

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

• none: creates a non-I/O optimized instance.
• 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 duration 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. 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. This parameter is empty by default.

• For Windows instances, this parameter is ignored The Password parameter takes effect 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 bidding policy for the pay-as-you-go instance. This parameter is valid only when the InstanceChargeType parameter is set to PostPaid. Valid values:

• NoSpot: The instance is a regular pay-as-you-go instance.
• SpotWithPriceLimit: The instance is created as a preemptible instance with a user-defined 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 bidding price.

The maximum hourly price of the instance. The value is accurate to three decimal places. This parameter is valid only when the SpotStrategy parameter is set to SpotWithPriceLimit.

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, Elastic Block Storage (EBS) device, and elastic network interface (ENI).

The ID of the resource group to which the launch template belongs.

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

• Active: enables security hardening. This value is applicable only to public images.
• Deactive: does not enable security hardening. This value is applicable to all images.

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 the VSwitchId parameter.

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

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

The data disks.

The information of the ENIs.

The tags to add to the instance, disks, and primary ENI that are created from the launch template.

Scenario

If you created a launch template by calling the CreateLaunchTemplate operation and use the default version that is automatically generated for the launch template to create instances, the specified tags are automatically added to the created instances, disks, and primary ENIs. For more information about the default versions of launch templates, see [xxxx](url).

The IDs of the security groups to which to assign the instance. The valid values of N are based on the maximum number of security groups to which the instance can belong. For more information, see the "Security group limits" section in 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. 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.