云服务器 ECS：CreateLaunchTemplateVersion - 在实例启动模板中创建新版本

地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

启动模板 ID。更多信息，请调用 DescribeLaunchTemplates 。您必须指定LaunchTemplateId或LaunchTemplateName以确定启动模板。

实例启动模板名称。长度为 2~128 个英文或中文字符。必须以大小写字母或中文开头，不能以http://或https://开头。可以包含数字、半角冒号（:）、下划线（_）或者短划线（-）。

实例启动模板版本的描述。长度为 2~256 个英文或中文字符，不能以http://或https://开头。

镜像 ID，启动实例时选择的镜像资源。您可以通过 DescribeImages 查询您可以使用的镜像资源。

镜像来源。

是否使用镜像预设的密码。取值范围：

• true。
• false。

默认值：false。

实例的规格。更多信息，请参见实例规格族，您也可以调用 DescribeInstanceTypes 接口获得最新的规格表。

指定使用该版本创建实例所属于的安全组 ID。同一个安全组内的实例之间可以互相访问。

实例所属专有网络 VPC ID。

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

实例名称。长度为 2~128 个字符，支持 Unicode 中 letter 分类下的字符（其中包括英文、中文和数字等）。可以包含半角冒号（:）、下划线（_）、半角句号（.）或者短划线（-）。默认值为实例的InstanceId。

创建多台 ECS 实例时，您可以批量设置有序的实例名称，并且可以包含方括号（[]）和逗号（,）。具体操作，请参见批量设置有序的实例名称或主机名称。

实例描述。长度为 2~256 个英文或中文字符，不能以http://或https://开头。

公网入带宽最大值，单位为 Mbit/s。取值范围：

• 当所购公网出带宽小于等于 10 Mbit/s 时：1~10，默认为 10。
• 当所购公网出带宽大于 10 Mbit/s 时：1~InternetMaxBandwidthOut的取值，默认为InternetMaxBandwidthOut的取值。

公网出带宽最大值，单位为 Mbit/s。取值范围为 0~100。

云服务器的主机名。

• 半角句号（.）和短划线（-）不能作为首尾字符，更不能连续使用。
• Windows 实例：字符长度为 2~15，不支持半角句号（.），不能全是数字。允许大小写英文字母、数字和短划线（-）。
• 其他类型实例（Linux 等）：字符长度为 2~64，支持多个半角句号（.），半角句号之间为一段，每段允许大小写英文字母、数字和短划线（-）。

实例所属的可用区 ID。

系统盘的云盘种类。取值范围：

• cloud：普通云盘。
• cloud_efficiency：高效云盘。
• cloud_ssd：SSD 云盘。
• cloud_auto：ESSD AutoPL 云盘。
• cloud_essd：ESSD 云盘。您可以通过参数SystemDisk.PerformanceLevel设置云盘的性能等级。
• cloud_essd_entry：ESSD Entry 云盘。

已停售的实例规格且非 I/O 优化实例默认值为 cloud，否则默认值为 cloud_efficiency。

系统盘大小，单位为 GiB。取值范围：

• cloud：20~500。
• 其他云盘种类：20~2048。

该参数的取值必须大于或者等于 max{20, ImageSize}。

系统盘名称。长度为 2~128 个英文或中文字符。必须以大小写字母或中文开头，不能以http://或https://开头。可以包含数字、半角冒号（:）、下划线（_）或者短划线（-）。

系统盘描述。长度为 2~256 个英文或中文字符，不能以http://或https://开头。

创建 ESSD 云盘作为系统盘使用时，设置云盘的性能等级。取值范围：

• PL0（默认）：单盘最高随机读写 IOPS 1 万。
• PL1：单盘最高随机读写 IOPS 5 万。
• PL2：单盘最高随机读写 IOPS 10 万。
• PL3：单盘最高随机读写 IOPS 100 万。

有关如何选择 ESSD 性能等级，请参见 ESSD 云盘。

系统盘是否随实例释放。取值范围：

• true：随实例释放。
• false：不随实例释放。

默认值：true。

系统盘采用的自动快照策略 ID。

是否修改 ESSD AutoPL 云盘预配置读写 IOPS。取值范围：0~min{50000, 1000*容量-基准性能}。

基准性能=min{1,800+50*容量, 50,000}。

是否开启 Burst（性能突发）。取值范围：

• true：是。
• false：否。

是否为 I/O 优化实例。取值范围：

• none：非 I/O 优化。
• optimized：I/O 优化。

实例的计费方式。取值范围：

• PrePaid：包年包月。选择该类计费方式时，您必须确认自己的账号支持信用支付，否则将返回InvalidPayMethod的错误提示。
• PostPaid：按量付费。

购买资源的时长，单位为：月。当参数InstanceChargeType取值为PrePaid时该参数才生效且为必选值。取值范围：1、2、3、4、5、6、7、8、9、12、24、36、48、60。

公网出方向带宽计费方式。取值范围：

• PayByBandwidth：按固定带宽计费。
• PayByTraffic：按使用流量计费。

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

实例网络类型。取值范围：

• classic：经典网络。
• vpc：专有网络 VPC。

实例自定义数据，需要以 Base64 方式编码，原始数据最多为 32 KB。

密钥对名称。

• Windows 实例，忽略该参数。即使填写了该参数，仍旧只执行Password的内容。
• Linux 实例的密码登录方式会被初始化成禁止。

实例 RAM 角色名称。您可以使用 RAM API ListRoles 查询您已创建的实例 RAM 角色。

自动释放时间。按照ISO 8601标准表示，并需要使用 UTC 时间。格式为：yyyy-MM-ddTHH:mm:ssZ。

• 如果秒（ss）取值不是00，则自动取为当前分钟（mm）开始时。

• 最短释放时间为当前时间半小时之后。

• 最长释放时间不能超过当前时间三年。

按量实例的抢占策略。当参数InstanceChargeType取值为PostPaid时生效。取值范围：

• NoSpot：正常按量付费实例。
• SpotWithPriceLimit：设置上限价格的抢占式实例。
• SpotAsPriceGo：系统自动出价，跟随当前市场实际价格。

设置实例的每小时最高价格。支持最大 3 位小数。

抢占式实例的保留时长，单位为小时。 默认值：1。取值范围：

• 1：创建后阿里云会保证实例运行 1 小时不会被自动释放；超过 1 小时后，系统会自动比较出价与市场价格、检查资源库存，来决定实例的持有和回收。
• 0：创建后，阿里云不保证实例运行 1 小时，系统会自动比较出价与市场价格、检查资源库存，来决定实例的持有和回收。

实例回收前 5 分钟阿里云会通过 ECS 系统事件向您发送通知。抢占式实例按秒计费，建议您结合具体任务执行耗时来选择合适的保留时长。

资源组 ID。

是否为操作系统开启安全加固。取值范围：

• Active：启用安全加固，只对公共镜像生效。
• Deactive：不启用安全加固，对所有镜像类型生效。

实例私网 IP 地址。

专有网络 VPC 类型 ECS 实例设置私网 IP 地址时，必须从虚拟交换机（VSwitchId）的空闲网段中选择。

为主网卡指定随机生成的 IPv6 地址数量。取值范围为 1~10。

部署集 ID。

数据盘列表。

弹性网卡信息。

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

实例加入的一个或多个安全组。N 的取值范围与实例能够加入安全组配额有关。更多信息，使用限制。

系统盘是否加密。取值范围：

• true：加密。

• false：不加密。

默认值：false。

实例释放保护属性，指定是否支持通过控制台或 API（ DeleteInstance ）释放实例。取值范围：

• true：开启实例释放保护。

• false：关闭实例释放保护。

默认值：false。

设置突发性能实例的运行模式。取值范围：

• Standard：标准模式，实例性能请参见什么是突发性能实例下的性能约束模式章节。
• Unlimited：无性能约束模式，实例性能请参见什么是突发性能实例下的无性能约束模式章节。

是否要自动续费。当参数InstanceChargeType取值PrePaid时才生效。取值范围：

• true：自动续费。
• false：不自动续费。

默认值：false。

单次自动续费的续费时长。取值范围：

PeriodUnit=Month 时：1、2、3、6、12、24、36、48、60。

默认值：1。

包年包月计费方式的时长单位。取值范围：

Month（默认）。

是否启用实例元数据的访问通道。取值范围：

• enabled：启用。
• disabled：禁用。

默认值：enabled。

访问实例元数据时是否强制使用加固模式（IMDSv2）。取值范围：

• optional：不强制使用。
• required：强制使用。设置该取值后，普通模式无法访问实例元数据。

默认值：optional。