Skip to content

LaunchTemplateProps

Properties for defining a LaunchTemplate.

See https://www.alibabacloud.com/help/ros/developer-reference/aliyun-ecs-launchtemplate

Initializer

using AlibabaCloud.SDK.ROS.CDK.Ecs;
new LaunchTemplateProps {
    object LaunchTemplateName,
    object AutoReleaseTime = null,
    object DeploymentSetId = null,
    object Description = null,
    object DiskMappings = null,
    object HostName = null,
    object ImageId = null,
    object ImageOwnerAlias = null,
    object InstanceChargeType = null,
    object InstanceName = null,
    object InstanceType = null,
    object InternetChargeType = null,
    object InternetMaxBandwidthOut = null,
    object IoOptimized = null,
    object Ipv6AddressCount = null,
    object KeyPairName = null,
    object NetworkInterfaces = null,
    object NetworkType = null,
    object PasswordInherit = null,
    object Period = null,
    object PrivateIpAddress = null,
    object RamRoleName = null,
    object ResourceGroupId = null,
    object SecurityEnhancementStrategy = null,
    object SecurityGroupId = null,
    object SecurityGroupIds = null,
    object SpotDuration = null,
    object SpotPriceLimit = null,
    object SpotStrategy = null,
    object SystemDiskCategory = null,
    object SystemDiskDeleteWithInstance = null,
    object SystemDiskDescription = null,
    object SystemDiskDiskName = null,
    object SystemDiskPerformanceLevel = null,
    object SystemDiskSize = null,
    TagsProperty[] Tags = null,
    object TemplateResourceGroupId = null,
    object TemplateTags = null,
    object UserData = null,
    object VersionDescription = null,
    object VSwitchId = null,
    object ZoneId = null
};

Properties

Name Type Description
LaunchTemplateName object Property launchTemplateName: The name of launch template.
AutoReleaseTime object Property autoReleaseTime: Auto release time for created instance, Follow ISO8601 standard using UTC time.
DeploymentSetId object Property deploymentSetId: The ID of the deployment set.
Description object Property description: Description of the instance, [2, 256] characters.
DiskMappings object Property diskMappings: Disk mappings to attach to instance.
HostName object Property hostName: Host name of created ecs instance.
ImageId object Property imageId: Image ID to create ecs instance.
ImageOwnerAlias object Property imageOwnerAlias: The source of the image.
InstanceChargeType object Property instanceChargeType: The billing method of the instance.
InstanceName object Property instanceName: Display name of the instance, [2, 128] English or Chinese characters, must start with a letter or Chinese in size, can contain numbers, '_' or '.', '-'.
InstanceType object Property instanceType: Ecs instance supported instance type, make sure it should be correct.
InternetChargeType object Property internetChargeType: Instance internet access charge type.Support 'PayByBandwidth' and 'PayByTraffic' only.
InternetMaxBandwidthOut object Property internetMaxBandwidthOut: Max internet out bandwidth in Mbps(Mega bit per second).
IoOptimized object Property ioOptimized: The 'optimized' instance can provide better IO performance.
Ipv6AddressCount object Property ipv6AddressCount: The number of IPv6 addresses to be randomly generated for the primary ENI.
KeyPairName object Property keyPairName: SSH key pair name.
NetworkInterfaces object Property networkInterfaces: Elastic network interfaces to be attached to instance.
NetworkType object Property networkType: Instance network type.
PasswordInherit object Property passwordInherit: Specifies whether to use the password preset in the image.
Period object Property period: The subscription period of the instance.
PrivateIpAddress object Property privateIpAddress: The private IP address of the instance.
RamRoleName object Property ramRoleName: Instance RAM role name.
ResourceGroupId object Property resourceGroupId: The ID of the resource group to which to assign the instance, Elastic Block Storage (EBS) device, and elastic network interface (ENI).
SecurityEnhancementStrategy object Property securityEnhancementStrategy: Activate or deactivate security enhancement,Value range: "Active" and "Deactive".
SecurityGroupId object Property securityGroupId: Security group to create ecs instance.
SecurityGroupIds object Property securityGroupIds: The ID of security group list to which to assign the instance.
SpotDuration object Property spotDuration: The protection period of the preemptible instance.
SpotPriceLimit object Property spotPriceLimit: The hourly price threshold of a instance, and it takes effect only when parameter InstanceChargeType is PostPaid.
SpotStrategy object Property spotStrategy: The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter InstanceChargeType is PostPaid.
SystemDiskCategory object Property systemDiskCategory: Category of system disk.
SystemDiskDeleteWithInstance object Property systemDiskDeleteWithInstance: Specifies whether to release the system disk when the instance is released.
SystemDiskDescription object Property systemDiskDescription: Description of created system disk.
SystemDiskDiskName object Property systemDiskDiskName: Name of created system disk.
SystemDiskPerformanceLevel object Property systemDiskPerformanceLevel: The performance level of the ESSD that is used as the system disk.
SystemDiskSize object Property systemDiskSize: Disk size of the system disk, range from 20 to 500 GB.
Tags TagsProperty[] Property tags: Tags to attach to instance, security group, disk and network interface.
TemplateResourceGroupId object Property templateResourceGroupId: The ID of the resource group to which to assign the launch template.
TemplateTags object Property templateTags: Template tags to attach to launch template.
UserData object Property userData: User data to pass to instance.
VersionDescription object Property versionDescription: Description for version 1 of launch template.
VSwitchId object Property vSwitchId: The vSwitch Id to create ecs instance.
ZoneId object Property zoneId: Current zone to create the instance.

LaunchTemplateNameRequired

public object LaunchTemplateName { get; set; }
  • Type: object

Property launchTemplateName: The name of launch template.


AutoReleaseTimeOptional

public object AutoReleaseTime { get; set; }
  • Type: object

Property autoReleaseTime: Auto release time for created instance, Follow ISO8601 standard using UTC time.

format is 'yyyy-MM-ddTHH:mm:ssZ'. Not bigger than 3 years from this day onwards


DeploymentSetIdOptional

public object DeploymentSetId { get; set; }
  • Type: object

Property deploymentSetId: The ID of the deployment set.


DescriptionOptional

public object Description { get; set; }
  • Type: object

Property description: Description of the instance, [2, 256] characters.


DiskMappingsOptional

public object DiskMappings { get; set; }
  • Type: object

Property diskMappings: Disk mappings to attach to instance.

Max support 16 disks.


HostNameOptional

public object HostName { get; set; }
  • Type: object

Property hostName: Host name of created ecs instance.

at least 2 characters, and '.' '-' Is not the first and last characters as hostname, not continuous use. Windows platform can be up to 15 characters, allowing letters (without limiting case), numbers and '-', and does not support the number of points, not all is digital ('.').Other (Linux, etc.) platform up to 30 characters, allowing support number multiple points for the period between the points, each permit letters (without limiting case), numbers and '-' components.


ImageIdOptional

public object ImageId { get; set; }
  • Type: object

Property imageId: Image ID to create ecs instance.


ImageOwnerAliasOptional

public object ImageOwnerAlias { get; set; }
  • Type: object

Property imageOwnerAlias: The source of the image.

Valid values: system: public images provided by Alibaba Cloud. self: your custom images. others: shared images from other Alibaba Cloud accounts. marketplace: Alibaba Cloud Marketplace images. If Alibaba Cloud Marketplace images are found, you can use these images without prior subscription. You must pay attention to the billing details of Alibaba Cloud Marketplace images.


InstanceChargeTypeOptional

public object InstanceChargeType { get; set; }
  • Type: object

Property instanceChargeType: The billing method of the instance.

Valid values: PrePaid: subscription. If you set this parameter to PrePaid, make sure that your account supports payment by credit. Otherwise, an InvalidPayMethod error is returned. PostPaid: pay-as-you-go.


InstanceNameOptional

public object InstanceName { get; set; }
  • Type: object

Property instanceName: Display name of the instance, [2, 128] English or Chinese characters, must start with a letter or Chinese in size, can contain numbers, '_' or '.', '-'.


InstanceTypeOptional

public object InstanceType { get; set; }
  • Type: object

Property instanceType: Ecs instance supported instance type, make sure it should be correct.


InternetChargeTypeOptional

public object InternetChargeType { get; set; }
  • Type: object

Property internetChargeType: Instance internet access charge type.Support 'PayByBandwidth' and 'PayByTraffic' only.


InternetMaxBandwidthOutOptional

public object InternetMaxBandwidthOut { get; set; }
  • Type: object

Property internetMaxBandwidthOut: Max internet out bandwidth in Mbps(Mega bit per second).

Range is [0,200].While the property is not 0, public ip will be assigned for instance.


IoOptimizedOptional

public object IoOptimized { get; set; }
  • Type: object

Property ioOptimized: The 'optimized' instance can provide better IO performance.

Support 'none' and 'optimized' only.


Ipv6AddressCountOptional

public object Ipv6AddressCount { get; set; }
  • Type: object

Property ipv6AddressCount: The number of IPv6 addresses to be randomly generated for the primary ENI.

Valid values: 1 to 10.


KeyPairNameOptional

public object KeyPairName { get; set; }
  • Type: object

Property keyPairName: SSH key pair name.


NetworkInterfacesOptional

public object NetworkInterfaces { get; set; }
  • Type: object

Property networkInterfaces: Elastic network interfaces to be attached to instance.


NetworkTypeOptional

public object NetworkType { get; set; }
  • Type: object

Property networkType: Instance network type.

Support 'vpc' and 'classic'


PasswordInheritOptional

public object PasswordInherit { get; set; }
  • Type: object

Property passwordInherit: Specifies whether to use the password preset in the image.

Note When you use this parameter, leave Password empty and make sure that the selected image has a password preset.


PeriodOptional

public object Period { get; set; }
  • Type: object

Property period: 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.


PrivateIpAddressOptional

public object PrivateIpAddress { get; set; }
  • Type: object

Property privateIpAddress: The private IP address of 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.


RamRoleNameOptional

public object RamRoleName { get; set; }
  • Type: object

Property ramRoleName: Instance RAM role name.

The name is provided and maintained by Resource Access Management (RAM) and can be queried using ListRoles. For more information, see RAM API CreateRole and ListRoles.


ResourceGroupIdOptional

public object ResourceGroupId { get; set; }
  • Type: object

Property resourceGroupId: The ID of the resource group to which to assign the instance, Elastic Block Storage (EBS) device, and elastic network interface (ENI).


SecurityEnhancementStrategyOptional

public object SecurityEnhancementStrategy { get; set; }
  • Type: object

Property securityEnhancementStrategy: Activate or deactivate security enhancement,Value range: "Active" and "Deactive".


SecurityGroupIdOptional

public object SecurityGroupId { get; set; }
  • Type: object

Property securityGroupId: Security group to create ecs instance.

For classic instance need the security group not belong to VPC, for VPC instance, please make sure the security group belong to specified VPC.


SecurityGroupIdsOptional

public object SecurityGroupIds { get; set; }
  • Type: object

Property securityGroupIds: The ID of security group list to which to assign the instance.


SpotDurationOptional

public object SpotDuration { get; set; }
  • Type: object

Property spotDuration: The protection period of the preemptible instance.

Unit: hours. Valid values: 0, 1, 2, 3, 4, 5, and 6. Protection periods of 2, 3, 4, 5, and 6 hours are in invitational preview. If you want to set this parameter to one of these values, submit a ticket. If this parameter is set to 0, no protection period is configured for the preemptible instance. Default value: 1.


SpotPriceLimitOptional

public object SpotPriceLimit { get; set; }
  • Type: object

Property spotPriceLimit: The hourly price threshold of a instance, and it takes effect only when parameter InstanceChargeType is PostPaid.

Three decimals is allowed at most.


SpotStrategyOptional

public object SpotStrategy { get; set; }
  • Type: object

Property spotStrategy: The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter InstanceChargeType is PostPaid.

Value range: "NoSpot: A regular Pay-As-You-Go instance", "SpotWithPriceLimit: A price threshold for a spot instance, ""SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance. "


SystemDiskCategoryOptional

public object SystemDiskCategory { get; set; }
  • Type: object

Property systemDiskCategory: Category of system disk.

support cloud|cloud_efficiency|cloud_ssd|cloud_essd|ephemeral_ssd


SystemDiskDeleteWithInstanceOptional

public object SystemDiskDeleteWithInstance { get; set; }
  • Type: object

Property systemDiskDeleteWithInstance: Specifies whether to release the system disk when the instance is released.

Valid values: true: releases the system disk when the instance is released. false: does not release the system disk when the instance is released. Default value: true.


SystemDiskDescriptionOptional

public object SystemDiskDescription { get; set; }
  • Type: object

Property systemDiskDescription: Description of created system disk.


SystemDiskDiskNameOptional

public object SystemDiskDiskName { get; set; }
  • Type: object

Property systemDiskDiskName: Name of created system disk.


SystemDiskPerformanceLevelOptional

public object SystemDiskPerformanceLevel { get; set; }
  • Type: object

Property systemDiskPerformanceLevel: The performance level of the ESSD that is used as the system disk.

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.


SystemDiskSizeOptional

public object SystemDiskSize { get; set; }
  • Type: object

Property systemDiskSize: Disk size of the system disk, range from 20 to 500 GB.

If you specify with your own image, make sure the system disk size bigger than image size.


TagsOptional

public TagsProperty[] Tags { get; set; }

Property tags: Tags to attach to instance, security group, disk and network interface.


TemplateResourceGroupIdOptional

public object TemplateResourceGroupId { get; set; }
  • Type: object

Property templateResourceGroupId: The ID of the resource group to which to assign the launch template.


TemplateTagsOptional

public object TemplateTags { get; set; }
  • Type: object

Property templateTags: Template tags to attach to launch template.


UserDataOptional

public object UserData { get; set; }
  • Type: object

Property userData: User data to pass to instance.

[1, 16KB] characters.


VersionDescriptionOptional

public object VersionDescription { get; set; }
  • Type: object

Property versionDescription: Description for version 1 of launch template.


VSwitchIdOptional

public object VSwitchId { get; set; }
  • Type: object

Property vSwitchId: The vSwitch Id to create ecs instance.


ZoneIdOptional

public object ZoneId { get; set; }
  • Type: object

Property zoneId: Current zone to create the instance.