根据指定的实例启动模板创建一个版本。

描述

每个实例启动模板最多创建30个版本。我们不提供模板修改接口,但是提供版本迭代接口(CreateLaunchTemplateVersion)。当您想修改某个版本的参数时,能通过新建模板版本的方式修改。更多详情,请参阅CreateLaunchTemplate

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:CreateLaunchTemplateVersion
RegionId String 实例所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。
LaunchTemplateId String 实例启动模板ID。更多详情,请调用DescribeLaunchTemplates。您必须指定LaunchTemplateIdLaunchTemplateName以确定模板。
LaunchTemplateName String 实例启动模板名称。长度为[2, 128]个英文或中文字符。必须以大小字母或中文开头,不能以http://和https://开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。
VersionDescription String 实例启动模板版本的描述。长度为[2, 256]个英文或中文字符,不能以http://和https://开头。
ImageId String 镜像ID。
InstanceType String 实例类型。更多详情,请调用DescribeInstanceTypes接口获得最新的规格表。
SecurityGroupId String 安全组ID。
NetworkType String 实例网络类型。取值范围:classic | vpc
VSwitchId String 创建VPC类型实例时需要指定虚拟交换机ID。
InstanceName String 实例名称。长度为[2, 128]个英文或中文字符。必须以大小字母或中文开头,不能以http://和https://开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。
Description String 实例描述。长度为[2, 256]个英文或中文字符,不能以http://和https://开头。
InternetMaxBandwidthIn String 公网入带宽最大值,单位为Mbit/s。取值范围:[1,200]
InternetMaxBandwidthOut String 公网出带宽最大值,单位为Mbit/s。取值范围:[0, 100]
HostName String 实例主机名。
  • 点号(.)和短横线(-)不能作为首尾字符,更不能连续使用。
  • Windows实例:字符长度为[2, 15],不支持点号(.),不能全是数字。允许大小写英文字母、数字和短横线(-)。
  • 其他类型实例(Linux等):字符长度为[2, 64],支持多个点号(.),点之间为一段,每段允许大小写英文字母、数字和短横线(-)。
ZoneId String 实例所属的可用区ID。
SystemDisk.Category String 系统盘的磁盘种类。取值范围:
  • cloud:普通云盘
  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD云盘
  • ephemeral_ssd:本地SSD盘
SystemDisk.Size Integer 系统盘大小,单位为GiB。取值范围:[20, 500]
SystemDisk.DiskName String 系统盘名称。长度为[2, 128]个英文或中文字符。必须以大小字母或中文开头,不能以http://和https://开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。
SystemDisk.Description String 系统盘描述。长度为[2, 256]个英文或中文字符,不能以http://和https://开头。
DataDisk.n.Category String 数据盘的磁盘种类,n的取值范围为[1, 16]。取值范围:
  • cloud:普通云盘
  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD云盘
  • ephemeral_ssd:本地SSD盘
DataDisk.n.Size Integer 数据盘的容量大小,n的取值范围为[1, 16]。取值范围:
  • cloud:[5, 2000]
  • cloud_efficiency:[20, 32768]
  • cloud_ssd:[20, 32768]
  • ephemeral_ssd:[5, 800]
DataDisk.n.SnapshotId String 创建数据盘使用的快照,n的取值范围为[1, 16]。
DataDisk.n.Encrypted Boolean 是否加密数据盘,n的取值范围为[1, 16]。
DataDisk.n.DiskName String 数据盘名称,n的取值范围为[1, 16]。长度为[2, 128]个英文或中文字符。必须以大小字母或中文开头,不能以http://和https://开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。
DataDisk.n.Description String 数据盘描述,n的取值范围为[1, 16]。长度为[2, 256]个英文或中文字符,不能以http://和https://开头。
DataDisk.n.DeleteWithInstance String 数据盘是否随实例释放而释放,n的取值范围为[1, 16]。
IoOptimized String 是否为I/O优化实例。取值范围:
  • none:非I/O优化
  • optimized:I/O优化
NetworkInterface.1.PrimaryIpAddress String 弹性网卡的主私有 IP 地址。
NetworkInterface.1.VSwitchId String 弹性网卡所属的虚拟交换机 ID。实例与弹性网卡必须在同一VPC的同一可用区中,可以分属于不同交换机。
NetworkInterface.1.SecurityGroupId String 弹性网卡所属安全组的ID。弹性网卡的安全组和实例的安全组必须在同一个VPC下。
NetworkInterface.1.NetworkInterfaceName String 弹性网卡名称。
NetworkInterface.1.Description String 弹性网卡描述信息。
InternetChargeType String 公网带宽计费类型。取值范围:PayByTraffic
UserData String 实例自定义数据,需要以Base64方式编码,原始数据最多为16 KB。
KeyPairName String 密钥对名称。
  • Windows实例,忽略该参数。默认为空。即使填写了该参数,仍旧只执行Password的内容。
  • Linux实例的密码登录方式会被初始化成禁止。
RamRoleName String 实例RAM角色名称。您可以使用RAM API ListRoles 查询实例RAM角色名称。
AutoReleaseTime String 实例自动释放时间。按照ISO8601标准表示,并需要使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ。
SpotStrategy String 后付费实例的抢占策略。当参数InstanceChargeType取值为PostPaid时为生效。取值范围:
  • NoSpot:正常按量付费实例。
  • SpotWithPriceLimit:设置上限价格的抢占式实例。
  • SpotAsPriceGo:系统自动出价,最高按量付费价格。
SpotPriceLimit Float 设置实例的每小时最高价格。支持最大3位小数。
SecurityEnhancementStrategy String 是否开启安全加固。取值范围:Active | Deactive
Tag.n.Key String 启动模板的标签键。n的取值范围:[1, 20]。一旦传入该值,则不允许为空字符串。最多支持64个字符,不能以aliyun、acs:、http://或者https://开头。
Tag.n.Value String 启动模板的标签值。n的取值范围:[1, 20]。一旦传入该值,可以为空字符串。最多支持128个字符,不能以aliyun、acs:、http://或者https://开头。

返回参数

名称 类型 描述
LaunchTemplateVersionNumber Long 实例启动模板版本号

示例

请求示例
https://ecs.aliyuncs.com/?Action=CreateLaunchTemplateVersion
&RegionId=cn-hangzhou
&LaunchTemplateName=lt-name1
&InstanceType=ecs.cm4.6xlarge
&SecurityGroupId=sg-securitygroupid
&<公共请求参数>
返回示例

XML格式

<CreateLaunchTemplateVersionResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</RequestId>
    <LaunchTemplateVersionNumber>2</LaunchTemplateVersionNumber>
</CreateLaunchTemplateVersionResponse>
JSON格式
{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FExxxxx",
    "LaunchTemplateVersionNumber": 2
}

错误码

以下为本接口特有的错误码。更多错误码,请访问API错误中心

错误代码 错误信息 HTTP状态码 说明
InvalidLaunchTemplate.NotFound The specified LaunchTemplateId “{0}” LaunchTemplateName “{1}” is not found. 400 指定的LaunchTemplateIdLaunchTemplateName不存在。
MissingParameter The input parameter “{0}” that is mandatory for processing this request is not supplied. 400 缺失必需参数。
InvalidParameter the parameter(s) “{0}” provided is(are) invalid. 400 指定的参数不合法。
InvalidDescription.Malformed The specified parameter “VersionDescription” is not valid. 400 指定的VersionDescription不合法。
InvalidUserData.SizeExceeded The specified parameter UserData exceeds the size. 400 UserData原始数据最多为16 KB。
InvalidUserData.Base64FormatInvalid The specified parameter UserData must be base64 encoded. 400 UserData必须经过Base64编码。
LaunchTemplateVersionLimitExceed The maximum number of template’s versions is exceeded. 403 一个实例启动模板最多能创建30个版本。
InnerServiceFailed call inner service failed 403 服务器内部错误。