CreateLaunchTemplateVersion_云服务器 ECS_API调试-阿里云OpenAPI开发者门户

CreateLaunchTemplateVersion_云服务器 ECS_API调试

云服务器 ECS

2014-05-26

获取元数据获取 SDK 服务区域

找不到 API ? 点击反馈吧

参数配置

高级配置

输入参数

只看必填

注意事项

RegionId地域ID

LaunchTemplateId启动模板ID

LaunchTemplateName实例启动模板名称

VersionDescription实例启动模板版本的描述

ImageId镜像ID

ImageOwnerAlias镜像来源

PasswordInherit是否使用镜像预设的密码

InstanceType实例的规格

SecurityGroupId指定使用该版本创建实例所属于的安全组ID

VpcId实例所属专有网络VPC ID

VSwitchId创建VPC类型实例时需要指定虚拟交换机ID

InstanceName实例名称

Description实例描述

InternetMaxBandwidthIn公网入带宽最大值

InternetMaxBandwidthOut公网出带宽最大值

HostName云服务器的主机名

ZoneId实例所属的可用区ID

SystemDisk.Category系统盘的云盘种类

SystemDisk.Size系统盘大小

SystemDisk.DiskName系统盘名称

SystemDisk.Description系统盘描述

SystemDisk.Iops>该参数暂未开放使用

SystemDisk.PerformanceLevel创建ESSD云盘作为系统盘使用时

SystemDisk.DeleteWithInstance系统盘是否随实例释放

SystemDisk.AutoSnapshotPolicyId系统盘采用的自动快照策略ID

SystemDisk.ProvisionedIops是否修改ESSD AutoPL云盘预配...

SystemDisk.BurstingEnabled是否开启Burst（性能突发）

IoOptimized是否为I/O优化实例

InstanceChargeType实例的计费方式

Period购买资源的时长

InternetChargeType公网出方向带宽计费方式

EnableVmOsConfig是否启用实例操作系统配置

NetworkType实例网络类型

UserData实例自定义数据

KeyPairName密钥对名称

RamRoleName实例RAM角色名称

AutoReleaseTime自动释放时间

SpotStrategy按量实例的抢占策略

SpotPriceLimit设置实例的每小时最高价格

SpotDuration抢占式实例的保留时长

ResourceGroupId资源组ID

SecurityEnhancementStrategy是否为操作系统开启安全加固

PrivateIpAddress实例私网IP地址

Ipv6AddressCount为主网卡指定随机生成的IPv6地址数量

DeploymentSetId部署集ID

DataDisk数据盘列表

0数据盘列表

PerformanceLevel创建ESSD云盘作为数据盘使用时

Description数据盘描述

SnapshotId创建数据盘N使用的快照

Size第N个数据盘的容量大小

Device数据盘的挂载点

DiskName数据盘名称

Category数据盘N的云盘种类

DeleteWithInstance表示数据盘是否随实例释放

Encrypted数据盘是否加密

ProvisionedIops是否修改ESSD AutoPL云盘预配...

BurstingEnabled是否开启Burst（性能突发）

AutoSnapshotPolicyId数据盘采用的自动快照策略ID

添加

NetworkInterface弹性网卡信息

0弹性网卡信息

VSwitchId辅助弹性网卡所属的虚拟交换机ID

NetworkInterfaceName辅助弹性网卡名称

Description辅助弹性网卡描述信息

SecurityGroupId辅助弹性网卡所属安全组的ID

PrimaryIpAddress辅助弹性网卡的主私有IP地址

SecurityGroupIds辅助弹性网卡加入的一个或多个安全组

0辅助弹性网卡加入的一个或多个安全组

添加

InstanceType弹性网卡类型

NetworkInterfaceTrafficMode主网卡的通讯模式

DeleteOnRelease释放实例时是否保留网卡

添加

Tag通过该版本创建的实例、云盘和主网卡的标签信息

0通过该版本创建的实例、云盘和主网卡的标签信息

Key通过该版本创建的实例、云盘和主网卡的标签键

Value通过该版本创建的实例、云盘和主网卡的标签值

添加

SecurityGroupIds实例加入的一个或多个安全组

0实例加入的一个或多个安全组

添加

SystemDisk.Encrypted系统盘是否加密

DeletionProtection实例释放保护属性

CreditSpecification设置突发性能实例的运行模式

AutoRenew是否要自动续费

AutoRenewPeriod单次自动续费的续费时长

PeriodUnit包年包月计费方式的时长单位

HttpEndpoint是否启用实例元数据的访问通道

HttpTokens访问实例元数据时是否强制使用加固模式（...

HttpPutResponseHopLimit>该参数暂未开放使用

文档

调用结果

SDK 示例

CLI示例

接口说明

当您想修改某个版本的参数时，能通过新建模板版本的方式修改。每个实例启动模板最多创建 30 个版本。

请求参数

字段名称	字段详情
RegionIdstring	地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。示例值:cn-hangzhou参考取值来源: DescribeRegions
LaunchTemplateIdstring	启动模板 ID。更多信息，请调用 DescribeLaunchTemplates 。您必须指定`LaunchTemplateId`或`LaunchTemplateName`以确定启动模板。示例值:lt-m5eiaupmvm2op9d****参考取值来源: CreateLaunchTemplate DescribeLaunchTemplates ModifyLaunchTemplateDefaultVersion
LaunchTemplateNamestring	实例启动模板名称。长度为 2~128 个英文或中文字符。必须以大小写字母或中文开头，不能以`http://`或`https://`开头。可以包含数字、半角冒号（:）、下划线（_）或者短划线（-）。示例值:testLaunchTemplateName参考取值来源: CreateLaunchTemplate DescribeLaunchTemplates
VersionDescriptionstring	实例启动模板版本的描述。长度为 2~256 个英文或中文字符，不能以`http://`或`https://`开头。示例值:testVersionDescription
ImageIdstring	镜像 ID，启动实例时选择的镜像资源。您可以通过 DescribeImages 查询您可以使用的镜像资源。示例值:win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd参考取值来源: ImportImage CopyImage CreateImage ExportImage DescribeImages
ImageOwnerAliasstring	镜像来源。展开详情示例值:system参考取值来源: DescribeImages
PasswordInheritboolean	是否使用镜像预设的密码。取值范围：展开详情示例值:false
InstanceTypestring	实例的规格。更多信息，请参见实例规格族，您也可以调用 DescribeInstanceTypes 接口获得最新的规格表。示例值:ecs.g5.large参考取值来源: DescribeInstanceTypes CreateInstance
SecurityGroupIdstring	指定使用该版本创建实例所属于的安全组 ID。同一个安全组内的实例之间可以互相访问。展开详情示例值:sg-bp15ed6xe1yxeycg****参考取值来源: CreateSecurityGroup DescribeSecurityGroups
VpcIdstring	实例所属专有网络 VPC ID。示例值:vpc-bp12433upq1y5scen****
VSwitchIdstring	创建 VPC 类型实例时需要指定虚拟交换机 ID。示例值:vsw-bp1s5fnvk4gn2tws0****
InstanceNamestring	实例名称。长度为 2~128 个字符，支持 Unicode 中 letter 分类下的字符（其中包括英文、中文和数字等）。可以包含半角冒号（:）、下划线（_）、半角句号（.）或者短划线（-）。默认值为实例的`InstanceId`。展开详情示例值:k8s-node-[1,4]-alibabacloud参考取值来源: DescribeInstances ModifyManagedInstance DeregisterManagedInstance
Descriptionstring	实例描述。长度为 2~256 个英文或中文字符，不能以`http://`或`https://`开头。示例值:testDescription
InternetMaxBandwidthIninteger<int32>	公网入带宽最大值，单位为 Mbit/s。取值范围：展开详情示例值:50
InternetMaxBandwidthOutinteger<int32>	公网出带宽最大值，单位为 Mbit/s。取值范围为 0~100。示例值:5
HostNamestring	云服务器的主机名。展开详情示例值:testHostName
ZoneIdstring	实例所属的可用区 ID。示例值:cn-hangzhou-g参考取值来源: DescribeZones
SystemDisk.Categorystring	系统盘的云盘种类。取值范围：展开详情示例值:cloud_ssd
SystemDisk.Sizeinteger<int32>	系统盘大小，单位为 GiB。取值范围：展开详情示例值:40
SystemDisk.DiskNamestring	系统盘名称。长度为 2~128 个英文或中文字符。必须以大小写字母或中文开头，不能以`http://`或`https://`开头。可以包含数字、半角冒号（:）、下划线（_）或者短划线（-）。示例值:cloud_ssdSystem参考取值来源: DescribeDisks
SystemDisk.Descriptionstring	系统盘描述。长度为 2~256 个英文或中文字符，不能以`http://`或`https://`开头。示例值:testSystemDiskDescription
SystemDisk.Iopsinteger<int32>	说明该参数暂未开放使用。示例值:30000
SystemDisk.PerformanceLevelstring	创建 ESSD 云盘作为系统盘使用时，设置云盘的性能等级。取值范围：展开详情示例值:PL0
SystemDisk.DeleteWithInstanceboolean	系统盘是否随实例释放。取值范围：展开详情示例值:true
SystemDisk.AutoSnapshotPolicyIdstring	系统盘采用的自动快照策略 ID。示例值:sp-bp1dgzpaxwc4load****参考取值来源: DescribeAutoSnapshotPolicyEx CreateAutoSnapshotPolicy
SystemDisk.ProvisionedIopsinteger<int64>	是否修改 ESSD AutoPL 云盘预配置读写 IOPS。取值范围：0~min{50000, 1000*容量-基准性能}。展开详情注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:50000参考取值来源: DescribeDisks
SystemDisk.BurstingEnabledboolean	是否开启 Burst（性能突发）。取值范围：展开详情示例值:true
IoOptimizedstring	是否为 I/O 优化实例。取值范围：展开详情示例值:optimized
InstanceChargeTypestring	实例的计费方式。取值范围：展开详情示例值:PrePaid参考取值来源: DescribeInstances
Periodinteger<int32>	购买资源的时长，单位为：月。当参数`InstanceChargeType`取值为`PrePaid`时该参数才生效且为必选值。取值范围：1、2、3、4、5、6、7、8、9、12、24、36、48、60。示例值:1
InternetChargeTypestring	公网出方向带宽计费方式。取值范围：展开详情示例值:PayByTraffic
EnableVmOsConfigboolean	是否启用实例操作系统配置。示例值:false
NetworkTypestring	实例网络类型。取值范围：展开详情示例值:vpc
UserDatastring	实例自定义数据，需要以 Base64 方式编码，原始数据最多为 32 KB。示例值:ZWNobyBoZWxsbyBl****参考取值来源: DescribeUserData
KeyPairNamestring	密钥对名称。展开详情示例值:testKeyPairName参考取值来源: CreateKeyPair DetachKeyPair AttachKeyPair ImportKeyPair DescribeKeyPairs
RamRoleNamestring	实例 RAM 角色名称。您可以使用 RAM API ListRoles 查询您已创建的实例 RAM 角色。示例值:testRamRoleName参考取值来源: DetachInstanceRamRole AttachInstanceRamRole DescribeInstanceRamRole
AutoReleaseTimestring	自动释放时间。按照ISO 8601标准表示，并需要使用 UTC 时间。格式为：yyyy-MM-ddTHH:mm:ssZ。展开详情示例值:2018-01-01T12:05:00Z
SpotStrategystring	按量实例的抢占策略。当参数`InstanceChargeType`取值为`PostPaid`时生效。取值范围：展开详情示例值:NoSpot
SpotPriceLimitnumber<float>	设置实例的每小时最高价格。支持最大 3 位小数。示例值:0.97取值 <= 999999
SpotDurationinteger<int32>	抢占式实例的保留时长，单位为小时。默认值：1。取值范围：展开详情示例值:1
ResourceGroupIdstring	资源组 ID。示例值:rg-bp67acfmxazb4p****参考取值来源: DescribeSecurityGroups
SecurityEnhancementStrategystring	是否为操作系统开启安全加固。取值范围：展开详情示例值:Active
PrivateIpAddressstring	实例私网 IP 地址。展开详情示例值:10.1..参考取值来源: AssignPrivateIpAddresses
Ipv6AddressCountinteger<int32>	为主网卡指定随机生成的 IPv6 地址数量。取值范围为 1~10。示例值:1
DeploymentSetIdstring	部署集 ID。示例值:ds-bp1brhwhoqinyjd6****参考取值来源: CreateDeploymentSet DescribeDeploymentSets
DataDiskarray<object>	数据盘列表。子级条数 <= 16
NetworkInterfacearray<object>	弹性网卡信息。子级条数 <= 8
Tagarray<object>	通过该版本创建的实例、云盘和主网卡的标签信息。子级条数 <= 21
SecurityGroupIdsarray<string>	实例加入的一个或多个安全组。N 的取值范围与实例能够加入安全组配额有关。更多信息，使用限制。展开详情示例值:sg-bp15ed6xe1yxeycg7****子级条数 <= 16
SystemDisk.Encryptedstring	系统盘是否加密。取值范围：展开详情示例值:false参考取值来源: DescribeDiskEncryptionByDefaultStatus
DeletionProtectionboolean	实例释放保护属性，指定是否支持通过控制台或 API（ DeleteInstance ）释放实例。取值范围：展开详情示例值:false
CreditSpecificationstring	设置突发性能实例的运行模式。取值范围：展开详情示例值:Standard
AutoRenewboolean	是否要自动续费。当参数`InstanceChargeType`取值`PrePaid`时才生效。取值范围：展开详情示例值:true
AutoRenewPeriodinteger<int32>	单次自动续费的续费时长。取值范围：展开详情示例值:1
PeriodUnitstring	包年包月计费方式的时长单位。取值范围：展开详情示例值:Month
HttpEndpointstring	是否启用实例元数据的访问通道。取值范围：展开详情示例值:enabled
HttpTokensstring	访问实例元数据时是否强制使用加固模式（IMDSv2）。取值范围：展开详情示例值:optional
HttpPutResponseHopLimitinteger<int32>	说明该参数暂未开放使用。示例值:3

返回参数

字段名称	字段详情
LaunchTemplateVersionNumberinteger<int64>	创建成功的启动模板版本号。注意请注意，该值为 Long 类型，在某些语言中可能存在精度丢失的风险，请小心使用。示例值:2
RequestIdstring	请求 ID。示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DEX****
LaunchTemplateIdstring	启动模板 ID。更多信息，请参见 DescribeLaunchTemplates 。展开详情示例值:lt-bp1apo0bbbkuy0rj****

变更历史

	变更时间	变更内容概要	操作
	2025-02-17	变更请求参数NetworkInterface
	2024-10-12	新增请求参数HttpEndpoint 新增请求参数HttpTokens 新增请求参数HttpPutResponseHopLimit
	2024-05-28	新增请求参数AutoRenew 新增请求参数AutoRenewPeriod 新增请求参数PeriodUnit
	2023-10-18	新增请求参数CreditSpecification
	2023-08-01	新增请求参数DeletionProtection
	2023-03-10	变更返回参数
	2023-01-05	新增请求参数SystemDisk.Encrypted
	2022-07-11	变更请求参数DataDisk 变更请求参数NetworkInterface 新增请求参数SystemDisk.AutoSnapshotPolicyId 新增请求参数SystemDisk.ProvisionedIops 新增请求参数SystemDisk.BurstingEnabled

1
2
10 条/页