全部产品
Search

搜索本产品

    云服务器 ECS：CreateLaunchTemplate - 创建实例启动模板

    文档中心

    云服务器 ECS：CreateLaunchTemplate - 创建实例启动模板

    更新时间：Jun 29, 2026

    创建一个ECS实例启动模板，简称模板。实例启动模板能免除每次创建实例时都需要填入大量配置参数。

    接口说明

    调用 CreateLaunchTemplate 创建模板后，会自动生成该模板的一个默认版本，版本号为 1，您后续可以基于该模板创建多个版本（CreateLaunchTemplateVersion），版本号从 1 开始顺序递增。如果您在创建实例（ RunInstances ）时不指定模板版本号，会采用默认版本。

    实例启动模板的版本中包含用于创建实例的相关配置，例如实例所属地域、镜像 ID、实例规格、安全组 ID 和公网带宽等。如果版本中没有指定某一实例配置，您需要在创建实例时为实例指定该配置。

    调用该接口时，您需要注意：

    • 每个账号在一个地域最多能创建 30 个实例启动模板，且每个模板最多能有 30 个版本。

    • 实例启动模板的参数大多数为可选参数。创建模板时，阿里云不会验证模板中参数取值的存在性和有效性。只会在真正创建实例时校验参数取值的有效性。

    • 如果实例启动模板中设置了某一配置，创建实例（ RunInstances ）时就无法过滤掉该配置。例如，如果模板设置了HostName=LocalHost，RunInstances中HostName取值为空时，实例的主机名依然是LocalHost。如果您想覆盖HostName=LocalHost这一配置，可以在RunInstances中取HostName=MyHost或其他参数值。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ecs:CreateLaunchTemplate

    create

    *LaunchTemplate

    acs:ecs:{#regionId}:{#accountId}:launchtemplate/*

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    RegionId

    string

    是

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

    cn-hangzhou
    TemplateTag

    array<object>

    否

    启动模版自身的标签对信息。

    说明

    当前仅支持通过 API 创建和查询启动模板的标签，控制台无法创建或查看。

    object

    否

    启动模版自身的标签对信息。

    Key

    string

    否

    启动模板的标签键。N 的取值范围：1~20。一旦传入该值，则不允许为空字符串。最多支持 128 个字符，不能以aliyun或acs:开头，不能包含http://或https://。

    TestKey
    Value

    string

    否

    启动模板的标签值。N 的取值范围：1~20。一旦传入该值，可以为空字符串。最多支持 128 个字符，不能以aliyun或acs:开头，不能包含http://或https://。

    TestValue
    RegionId

    string

    是

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

    cn-hangzhou
    LaunchTemplateName

    string

    是

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

    testLaunchTemplateName
    VersionDescription

    string

    否

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

    testVersionDescription
    ImageId

    string

    否

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

    win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd
    ImageOwnerAlias

    string

    否

    镜像来源。取值范围：

    • system：阿里云提供的公共镜像。

    • self：您创建的自定义镜像。

    • others：其他阿里云用户共享给您的镜像。

    • marketplace：云市场提供的镜像。您查询到的云市场镜像可以直接使用，无需提前订阅。您需要自行留意云市场镜像的收费详情。

    system
    PasswordInherit

    boolean

    否

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

    说明

    使用该参数时，Password 参数必须为空，同时您需要确保使用的镜像已经设置了密码。

    false
    InstanceType

    string

    否

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

    ecs.g5.large
    SecurityGroupId

    string

    否

    指定新创建实例所属于的安全组 ID。同一个安全组内的实例之间可以互相访问，一个安全组最多能管理 1000 台实例。

    说明

    不支持同时指定SecurityGroupId和SecurityGroupIds.N。

    sg-bp15ed6xe1yxeycg****
    VpcId

    string

    否

    专有网络 VPC ID。

    vpc-bp12433upq1y5scen****
    VSwitchId

    string

    否

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

    vsw-bp1s5fnvk4gn2tws0****
    InstanceName

    string

    否

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

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

    k8s-node-[1,4]-alibabacloud
    Description

    string

    否

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

    testECSDescription
    InternetMaxBandwidthIn

    integer

    否

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

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

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

    10
    InternetMaxBandwidthOut

    integer

    否

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

    10
    HostName

    string

    否

    云服务器的主机名。

    • 半角句号（.）和短划线（-）不能作为首尾字符，更不能连续使用。

    • Windows 实例：字符长度为 2~15，不支持半角句号（.），不能全是数字。允许大小写英文字母、数字和短划线（-）。

    • 其他类型实例（Linux 等）：字符长度为 2~64，支持多个半角句号（.），半角句号之间为一段，每段允许大小写英文字母、数字和短划线（-）。

    testHostName
    ZoneId

    string

    否

    实例所属的可用区 ID。

    cn-hangzhou-g
    SystemDisk.Category

    string

    否

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

    • cloud：普通云盘。

    • cloud_efficiency：高效云盘。

    • cloud_ssd：SSD 云盘。

    • cloud_essd：ESSD 云盘。您可以通过参数SystemDisk.PerformanceLevel设置云盘的性能等级。

    • cloud_auto：ESSD AutoPL 云盘

    • cloud_essd_entry：ESSD Entry 云盘。

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

    cloud_ssd
    SystemDisk.Size

    integer

    否

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

    • cloud：20~500。

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

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

    40
    SystemDisk.DiskName

    string

    否

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

    testSystemDiskName
    SystemDisk.Description

    string

    否

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

    testSystemDiskDescription
    SystemDisk.Iops

    integer

    否

    说明

    该参数正在邀测中，暂未开放使用。

    null
    SystemDisk.PerformanceLevel

    string

    否

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

    • PL0（默认）：单盘最高随机读写 IOPS 1 万。

    • PL1：单盘最高随机读写 IOPS 5 万。

    • PL2：单盘最高随机读写 IOPS 10 万。

    • PL3：单盘最高随机读写 IOPS 100 万。

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

    PL0
    SystemDisk.DeleteWithInstance

    boolean

    否

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

    • true：随实例释放。

    • false：不随实例释放。

    默认值：true。

    true
    SystemDisk.AutoSnapshotPolicyId

    string

    否

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

    sp-gc7c37d4ylw7mtnk****
    SystemDisk.ProvisionedIops

    integer

    否

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

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

    说明

    当 DiskCategory 取值为 cloud_auto 时才支持设置该参数。更多信息，请参见ESSD AutoPL 云盘和修改 ESSD AutoPL 云盘预配置信息。

    50000
    SystemDisk.BurstingEnabled

    boolean

    否

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

    • true：是。

    • false：否。

    true
    IoOptimized

    string

    否

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

    • none：非 I/O 优化。

    • optimized：I/O 优化。

    optimized
    InstanceChargeType

    string

    否

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

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

    • PostPaid：按量付费。

    PrePaid
    Period

    integer

    否

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

    1
    InternetChargeType

    string

    否

    网络计费方式。取值范围：

    • PayByBandwidth：按固定带宽计费。

    • PayByTraffic：按使用流量计费。

    说明

    按使用流量计费模式下的出入带宽峰值都是带宽上限，不作为业务承诺指标。当出现资源争抢时，带宽峰值可能会受到限制。如果您的业务需要有带宽的保障，请使用按固定带宽计费模式。

    PayByTraffic
    EnableVmOsConfig

    boolean

    否

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

    说明

    该参数即将被弃用，为提高兼容性，请尽量使用其他参数。

    false
    NetworkType

    string

    否

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

    • classic：经典网络。该功能已下线，详情请参见下线公告。

    • vpc：专有网络 VPC。

    vpc
    UserData

    string

    否

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

    ZWNobyBoZWxsbyBlY3Mh
    KeyPairName

    string

    否

    密钥对名称。

    • Windows 实例，忽略该参数。即使填写了该参数，仍旧只执行Password的内容。

    • Linux 实例的密码登录方式会被初始化成禁止。

    testKeyPairName
    RamRoleName

    string

    否

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

    testRamRoleName
    AutoReleaseTime

    string

    否

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

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

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

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

    2018-01-01T12:05:00Z
    SpotStrategy

    string

    否

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

    • NoSpot：正常按量付费实例。

    • SpotWithPriceLimit：设置上限价格的抢占式实例。

    • SpotAsPriceGo：系统自动出价，跟随当前市场实际价格。

    NoSpot
    SpotPriceLimit

    number

    否

    设置实例的每小时最高价格。支持最大 3 位小数，参数SpotStrategy取值为SpotWithPriceLimit时生效。

    0.97
    SpotDuration

    integer

    否

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

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

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

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

    说明

    当 SpotStrategy 值为 SpotWithPriceLimit 或 SpotAsPriceGo 时该参数生效。

    1
    ResourceGroupId

    string

    否

    实例、块存储和弹性网卡所在的企业资源组 ID。

    rg-bp67acfmxazb4p****
    TemplateResourceGroupId

    string

    否

    启动模板所在的企业资源组 ID。

    rg-bp67acfmxazb4p****
    SecurityEnhancementStrategy

    string

    否

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

    • Active：启用安全加固，只对公共镜像生效。

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

    Deactive
    PrivateIpAddress

    string

    否

    实例私网 IP 地址。

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

    10.1.**.**
    DeploymentSetId

    string

    否

    部署集 ID。

    ds-bp1brhwhoqinyjd6****
    Ipv6AddressCount

    integer

    否

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

    1
    DataDisk

    array<object>

    否

    数据盘信息列表。

    object

    否

    数据盘信息列表。

    PerformanceLevel

    string

    否

    创建 ESSD 云盘作为数据盘使用时，设置云盘的性能等级。N 的取值必须和DataDisk.N.Category=cloud_essd中的 N 保持一致。取值范围：

    • PL0：单盘最高随机读写 IOPS 1 万。

    • PL1（默认）：单盘最高随机读写 IOPS 5 万。

    • PL2：单盘最高随机读写 IOPS 10 万。

    • PL3：单盘最高随机读写 IOPS 100 万。

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

    PL1
    Description

    string

    否

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

    testDataDiskDescription
    SnapshotId

    string

    否

    创建数据盘 N 使用的快照。N 的取值范围为 1~16。指定参数DataDisk.N.SnapshotId后，参数DataDisk.N.Size会被忽略，实际创建的云盘大小为指定的快照的大小。

    说明

    不能使用早于 2013 年 7 月 15 日（含）创建的快照，请求会报错被拒绝。

    s-bp17441ohwka0yuh****
    Size

    integer

    否

    第 N 个数据盘的容量大小，N 的取值范围为 1~16，内存单位为 GiB。取值范围：

    • cloud：5~2000

    • cloud_efficiency：20~32768

    • cloud_ssd：20~32768

    • cloud_essd：具体取值范围与DataDisk.N.PerformanceLevel的取值有关。

      • PL0：1~32768。

      • PL1：20~32768。

      • PL2：461~32768。

      • PL3：1261~32768。

    • cloud_auto：1~32,768。

    • cloud_essd_entry：10~32,768。

    该参数的取值必须大于等于参数SnapshotId指定的快照的大小。

    2000
    Device

    string

    否

    数据盘的挂载点。挂载的数据盘数量不同，挂载点的命名不同：

    • 1~25 块数据盘：/dev/xvd[b-z]

    • 大于 25 块数据盘：/dev/xvd[aa-zz]，例如第 26 块数据盘会被命名为/dev/xvdaa，第 27 块数据盘为/dev/xvdab，以此类推。

    说明

    该参数仅用于全镜像（整机镜像）场景。您可以通过将此参数设置为全镜像中数据盘对应的挂载点，并修改对应的DataDisk.N.Size和DataDisk.N.Category参数，达到修改全镜像中数据盘磁盘种类和大小的目的。

    /dev/xvdb

    DiskName

    string

    否

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

    testDataDiskName
    Category

    string

    否

    数据盘 N 的云盘种类。取值范围：

    • cloud_efficiency：高效云盘。

    • cloud_ssd：SSD 云盘。

    • cloud_essd：ESSD 云盘。

    • cloud：普通云盘。

    • cloud_auto：ESSD AutoPL 云盘。

    • cloud_regional_disk_auto：ESSD 同城冗余云盘。

    • cloud_essd_entry：ESSD Entry 云盘。
      说明

      仅当InstanceType设置为ecs.u1或ecs.e规格族时，该参数支持cloud_essd_entry。

    • elastic_ephemeral_disk_standard：弹性临时盘-标准版。

    • elastic_ephemeral_disk_premium：弹性临时盘-高级版。

    对于 I/O 优化实例，默认值为 cloud_efficiency。对于非 I/O 优化实例，默认值为 cloud。 参数默认值说明：

    • 当 InstanceType 为已停售且非 I/O 优化的实例规格，该参数默认值为cloud。

    • 其它情况下，该参数默认值为cloud_efficiency。

    cloud_ssd
    DeleteWithInstance

    boolean

    否

    表示数据盘是否随实例释放。取值范围：

    • true：随实例释放。

    • false：不随实例释放。

    默认值：true。

    true
    Encrypted

    string

    否

    数据盘是否加密。

    false
    AutoSnapshotPolicyId

    string

    否

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

    sp-m5e7fa9ute44ssa****
    ProvisionedIops

    integer

    否

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

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

    说明

    当 DiskCategory 取值为 cloud_auto 时才支持设置该参数。更多信息，请参见ESSD AutoPL 云盘和修改 ESSD AutoPL 云盘预配置信息。

    50000
    BurstingEnabled

    boolean

    否

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

    • true：是。

    • false：否。

    true
    KMSKeyId

    string

    否

    数据盘对应的 KMS 密钥 ID。

    0e478b7a-4262-4802-b8cb-00d****
    NetworkInterface

    array<object>

    否

    弹性网卡信息。

    object

    否

    弹性网卡信息。

    VSwitchId

    string

    否

    弹性网卡所属的虚拟交换机 ID。

    您需要注意：

    • N 的取值范围为 1~2，设置 1 个弹性网卡时，支持设置 1 个主网卡或 1 个辅助网卡；设置 2 个弹性网卡时，仅支持同时设置 1 个主网卡和 1 个辅助网卡。

    • 如果NetworkInterface.N.InstanceType取值为Primary，则必须设置该参数。此时该参数的作用等同于VSwitchId，但需要注意不能同时设置VSwitchId参数。

    • 如果NetworkInterface.N.InstanceType取值为Secondary或空值，则该参数为非必填参数。默认值为 ECS 实例所属的虚拟交换机。

    vsw-bp1s5fnvk4gn2tws0****
    NetworkInterfaceName

    string

    否

    弹性网卡名称。

    您需要注意：

    • N 的取值范围为 1~2，设置 1 个弹性网卡时，支持设置 1 个主网卡或 1 个辅助网卡；设置 2 个弹性网卡时，仅支持同时设置 1 个主网卡和 1 个辅助网卡。

    • 如果NetworkInterface.N.InstanceType取值为Primary，则无需设置该参数。

    testEniName
    Description

    string

    否

    辅助弹性网卡描述信息。长度为 2~256 个英文或中文字符，不能以http://或https://开头。NetworkInterface.N的 N 取值不能大于 1。

    testEniDescription
    SecurityGroupId

    string

    否

    弹性网卡所属的安全组 ID。

    您需要注意：

    • N 的取值范围为 1~2，设置 1 个弹性网卡时，支持设置 1 个主网卡或 1 个辅助网卡；设置 2 个弹性网卡时，仅支持同时设置 1 个主网卡和 1 个辅助网卡。

    • 如果NetworkInterface.N.InstanceType取值为Primary，则必须设置该参数。此时该参数的作用等同于SecurityGroupId，但需要注意不能再设置SecurityGroupId、SecurityGroupIds.N或NetworkInterface.N.SecurityGroupIds.N。

    • 如果NetworkInterface.N.InstanceType取值为Secondary或空值，则该参数为非必填参数。默认值为 ECS 实例所属的安全组。

    sg-bp15ed6xe1yxeycg****
    PrimaryIpAddress

    string

    否

    添加一张弹性网卡并设置主 IP 地址。

    您需要注意：

    • N 的取值范围为 1~2：

      • 设置 1 个弹性网卡时，支持设置 1 个主网卡或 1 个辅助网卡。如果Amount参数取值大于 1，且设置了主网卡并设置了该参数，则表示在批量创建 ECS 实例时，以指定的主 IP 地址为起始地址，依次为多台 ECS 实例分配连续的主 IP 地址，但需要注意，此时不支持再为实例绑定辅助网卡。

      • 设置 2 个弹性网卡时，仅支持同时设置 1 个主网卡和 1 个辅助网卡，但需要注意，如果Amount参数取值大于 1 且已为主网卡设置了该参数，则不支持再设置辅助网卡（即不支持再设置NetworkInterface.2.InstanceType=Secondary）。

    • 如果NetworkInterface.N.InstanceType取值为Primary，则该参数的作用等同于PrivateIpAddress，但需要注意不能同时设置PrivateIpAddress参数。

    • 如果NetworkInterface.N.InstanceType取值为Secondary或空值，表示为辅助网卡设置主 IP 地址。默认从网卡所属的交换机网段中随机选择一个 IP 地址。

    说明

    创建 ECS 实例时，您最多能添加一张辅助网卡。实例创建成功后，您可以调用 CreateNetworkInterface 和 AttachNetworkInterface 添加更多的辅助网卡。

    192.168.**.**
    SecurityGroupIds

    array

    否

    弹性网卡所属的一个或多个安全组 ID。

    • 第一个 N 的取值范围为 1~2，设置 1 个弹性网卡时，支持设置 1 个主网卡或 1 个辅助网卡；设置 2 个弹性网卡时，仅支持同时设置 1 个主网卡和 1 个辅助网卡。

    • 第二个 N 表示可以指定一个或多个安全组 ID。N 的取值范围与实例能够加入安全组配额有关，更多信息，请参见安全组限制。

    您需要注意：

    • 如果NetworkInterface.N.InstanceType取值为Primary，则必须设置该参数或NetworkInterface.N.SecurityGroupId。此时该参数的作用等同于SecurityGroupIds.N，但需要注意不能再设置SecurityGroupId、SecurityGroupIds.N或NetworkInterface.N.SecurityGroupId。

    • 如果NetworkInterface.N.InstanceType取值为Secondary或空值，则该参数为非必填参数。默认值为 ECS 实例所属的安全组。

    sg-bp67acfmxazb4p****

    string

    否

    弹性网卡所属的一个或多个安全组 ID。

    • 第一个 N 的取值范围为 1~2，设置 1 个弹性网卡时，支持设置 1 个主网卡或 1 个辅助网卡；设置 2 个弹性网卡时，仅支持同时设置 1 个主网卡和 1 个辅助网卡。

    • 第二个 N 表示可以指定一个或多个安全组 ID。N 的取值范围与实例能够加入安全组配额有关，更多信息，请参见安全组限制。

    您需要注意：

    • 如果NetworkInterface.N.InstanceType取值为Primary，则必须设置该参数或NetworkInterface.N.SecurityGroupId。此时该参数的作用等同于SecurityGroupIds.N，但需要注意不能再设置SecurityGroupId、SecurityGroupIds.N或NetworkInterface.N.SecurityGroupId。

    • 如果NetworkInterface.N.InstanceType取值为Secondary或空值，则该参数为非必填参数。默认值为 ECS 实例所属的安全组。

    sg-bp67acfmxazb4p****
    InstanceType

    string

    否

    弹性网卡类型。N 的取值范围为 1~2，设置 1 个弹性网卡时，支持设置 1 个主网卡或 1 个辅助网卡；设置 2 个弹性网卡时，仅支持同时设置 1 个主网卡和 1 个辅助网卡。

    参数取值范围：

    • Primary：主网卡。

    • Secondary：辅助网卡。

    默认值：Secondary。

    Secondary
    NetworkInterfaceTrafficMode

    string

    否

    主网卡的通讯模式。参数取值范围：

    • Standard：使用 TCP 通讯模式。

    • HighPerformance：开启 ERI（Elastic RDMA Interface）接口，使用 RDMA 通讯模式。

    Standard
    DeleteOnRelease

    boolean

    否

    释放实例时是否保留网卡。取值范围：

    • true：不保留。

    • false：保留。

    默认值：true。

    说明

    该参数只对辅助网卡生效。

    true
    Tag

    array<object>

    否

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

    使用场景

    通过调用 CreateLaunchTemplate 接口创建模版后，使用自动生成的默认版本来创建实例时，将使用此标签来标记实例、云盘和主网卡。

    object

    否

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

    Key

    string

    否

    通过该模板的版本创建的实例、云盘和主网卡的标签键。N 的取值范围：1~20。一旦传入该值，则不允许为空字符串。最多支持 128 个字符，不能以 aliyun 和 acs:开头，不能包含 http://或 https://。

    TestKey
    Value

    string

    否

    通过该模板的版本创建的实例、云盘和主网卡的标签值。N 的取值范围：1~20。一旦传入该值，可以为空字符串。最多支持 128 个字符，不能包含 http://或者 https://。

    TestValue
    SecurityGroupIds

    array

    否

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

    说明

    不支持同时指定SecurityGroupId和SecurityGroupIds.N。

    sg-bp15ed6xe1yxeycg7****

    string

    否

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

    说明

    不支持同时指定SecurityGroupId和SecurityGroupIds.N。

    sg-bp15ed6xe1yxeycg7****
    SystemDisk.Encrypted

    string

    否

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

    • true：加密。

    • false：不加密。

    默认值：false。

    说明

    中国香港 D 可用区、新加坡 A 可用区暂不支持在创建实例时加密系统盘。

    false
    DeletionProtection

    boolean

    否

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

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

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

    默认值：false。

    说明

    该属性仅适用于按量付费实例，且只能限制手动释放操作，对系统释放操作不生效。

    false
    CreditSpecification

    string

    否

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

    Standard
    AutoRenew

    boolean

    否

    是否要自动续费。取值范围：

    • true：自动续费。

    • false：不自动续费。

    默认值：false。

    说明

    当参数InstanceChargeType取值PrePaid时才生效。

    true
    AutoRenewPeriod

    integer

    否

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

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

    默认值：1。

    1
    PeriodUnit

    string

    否

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

    Month（默认）。

    Month
    HttpEndpoint

    string

    否

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

    • enabled：启用。

    • disabled：禁用。

    默认值：enabled。

    说明

    有关实例元数据的信息，请参见实例元数据概述。

    enabled
    HttpTokens

    string

    否

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

    • optional：不强制使用。

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

    默认值：optional。

    说明

    有关访问实例元数据的模式，请参见实例元数据概述。

    optional
    HttpPutResponseHopLimit

    integer

    否

    说明

    该参数暂未开放使用。

    3
    SystemDisk.KMSKeyId

    string

    否

    系统盘对应的 KMS 密钥 ID。

    0e478b7a-4262-4802-b8cb-00d3fb40****
    ImageOptions

    object

    否

    镜像相关属性信息。

    LoginAsNonRoot

    boolean

    否

    使用该镜像的实例是否支持使用 ecs-user 用户登录。 可能值：

    • true：是。

    • false：否。

    false
    SecurityOptions

    object

    否

    安全选项。

    TrustedSystemMode

    string

    否

    可信系统模式。取值：vTPM。

    目前，可信系统模式支持的实例规格族：

    • g7、c7、r7。

    • 安全增强型（g7t、c7t、r7t）。

    当您创建以上实例规格族的 ECS 实例时，需要设置该参数。具体说明如下：

    • 如果您使用阿里云可信系统，请将该参数值设置为 vTPM，在实例启动时即可通过阿里云可信系统完成可信校验。

    • 如果您不使用阿里云可信系统，可以不设置该参数值，但您需要注意，如果您所创建的 ECS 实例使用了 Enclave 机密计算模式（SecurityOptions.ConfidentialComputingMode=Enclave），则该 ECS 实例也会启用可信系统。

    • 通过 OpenAPI 创建可信系统的 ECS 实例时，只能调用RunInstances实现，CreateInstance目前不支持设置SecurityOptions.TrustedSystemMode参数。

    说明

    如果您在创建实例的时候指定其为可信实例，那么当您更换系统盘时只能使用支持可信系统的镜像。

    关于可信系统的更多信息，请参见安全增强型实例可信功能概述。

    vTPM

    返回参数

    名称

    类型

    描述

    示例值

    object

    LaunchTemplateId

    string

    实例启动模板 ID。

    lt-m5eiaupmvm2op9d****
    RequestId

    string

    请求 ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    LaunchTemplateVersionNumber

    integer

    实例启动模板版本号。

    20

    示例

    正常返回示例

    JSON格式

    {
  "LaunchTemplateId": "lt-m5eiaupmvm2op9d****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "LaunchTemplateVersionNumber": 20
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 InvalidRegion.NotExist %s 指定的地域不存在，请确认参数是否正确。
    400 MissingParameter %s 缺失参数，请检查参数是否完整。
    400 InvalidParameter %s 无效的参数。
    400 InvalidLaunchTemplateName.Malformed The specified parameter LaunchTemplateName is not valid. 指定的参数 LaunchTemplateName 无效。
    400 InvalidDescription.Malformed The specified parameter "VersionDescription" is not valid.
    400 InvalidUserData.SizeExceeded %s 您设置的数据大小超过了允许的最大值。
    400 InvalidUserData.Base64FormatInvalid %s 您设置的数据格式不正确，请选择规定的格式数据。
    400 Duplicate.TagKey The Tag.N.Key contain duplicate key. 标签中存在重复的键，请保持键的唯一性。
    400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. 指定的标签键参数有误。
    400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. 指定的标签值参数有误。
    400 InvalidHostName.Malformed The specified parameter "HostName" is not valid. 指定的参数 HostName 不合法
    400 InvalidParams.CreateEniParams %s
    500 InternalError The request processing has failed due to some unknown error.
    403 LaunchTemplateLimitExceed %s 超出启动模版数量限制。
    403 LaunchTemplateName.Duplicated %s 指定的启动模版名称已经存在。
    403 QuotaExceed.Tags %s 标签数超过可以配置的最大数量。%s为变量，将根据调用API的实际情况动态返回错误信息。
    404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. 资源组并不在记录中。

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。