创建模板 - CreateLaunchTemplate

ecs:launchTemplates:create

write

-

-

-

-

launch_template

是

Object

参数解释：

模板信息。详情请参见表3。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

dry_run

否

Boolean

参数解释：

是否只预检此次请求。配置为预检时，此次请求不会创建模板。

约束限制：

不涉及

取值范围：

• true：预检此次请求，检查项包括是否填写了必需参数、请求格式等。
  • 如果检查不通过，则返回对应错误。
  • 如果检查通过，则返回202状态码。
• false：发送正常请求，不对请求体做预检。

默认取值：

false

template_data

否

Object

参数解释：

模板创建请求信息。详情请参见表4。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

name

是

String

参数解释：

模板名称。

约束限制：

不涉及

取值范围：

• 长度为1~64个字符。
• 只能由中文、英文、数字、中划线（-）、下划线（_)、小数点（.）等字符组成。

默认取值：

不涉及

description

否

String

参数解释：

模板描述。

约束限制：

不涉及

取值范围：

最大长度为85个字符。

默认取值：

不涉及

version_description

否

String

参数解释：

初始第一个版本的版本描述。

约束限制：

不涉及

取值范围：

最大长度为85个字符。

默认取值：

不涉及

flavor_id

否

String

参数解释：

依据模板创建云服务器的规格ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

name

否

String

参数解释：

云服务器名称。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

description

否

String

参数解释：

云服务器描述信息。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

availability_zone_id

否

String

参数解释：

可用区。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

enterprise_project_id

否

String

参数解释：

企业项目ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

auto_recovery

否

Boolean

参数解释：

是否配置云服务器自动恢复的功能。

约束限制：

不涉及

取值范围：

• true：表示配置自动恢复功能。
• false：表示不配置自动恢复功能。

默认取值：

不涉及

os_profile

否

Object

参数解释：

镜像属性。详情请参见表5。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

security_group_ids

否

Array of strings

参数解释：

安全组ID列表。全网卡生效。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

network_interfaces

否

Array of Objects

参数解释：

网络接口。详情请参见表6。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

block_device_mappings

否

Array of Objects

参数解释：

BDM挂载信息。按flavor限制为准。详情请参见表8。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

market_options

否

Object

参数解释：

计费信息。详情请参见表10。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

internet_access

否

Object

参数解释：

公网访问。详情请参见表12。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

metadata

否

Map<String,String>

参数解释：

云服务器元数据。

可以通过元数据自定义键值对。系统预留键值对请参见表11。

约束限制：

不涉及

取值范围：

• key：长度大于0小于256字节。
• value：长度大于等于0小于256字节。

默认取值：

不涉及

tag_options

否

Array of Objects

参数解释：

创建虚拟机标签，目前仅支持给虚拟机打标签，后续会支持同时给相关资源如卷等打标签。

详情请参见表15。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

key_name

否

String

参数解释：

使用SSH密钥方式登录云服务器时，指定已创建密钥（keypair）的名称。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

user_data

否

String

参数解释：

创建云服务器过程中待注入实例自定义数据。支持注入文本、文本文件。

约束限制：

• user_data的值为base64编码之后的内容。
• 注入内容（编码之前的内容）最大长度为32K。

取值范围：

不涉及

默认取值：

不涉及

iam_agency_name

否

String

参数解释：

委托名称。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

enable_monitoring_service

否

Boolean

参数解释：

开启主机监控服务。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

virsubnet_id

否

String

参数解释：

子网ID。

约束限制：

需要指定vpcid对应VPC下已创建的子网（subnet）的网络ID，UUID格式。

可以通过VPC服务查询子网列表接口查询。

取值范围：

不涉及

默认取值：

不涉及

attachment

否

Object

参数解释：

网卡信息。详情请参见表7。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

device_index

否

Integer

参数解释：

网卡挂载在云服务器上的相对前后位置，主网卡为0。

约束限制：

• 不能多个网卡都设置为0。
• 当未设置device_index时，系统按照列表顺序分配。

取值范围：

不涉及

默认取值：

不涉及

source_id

否

String

参数解释：

虚拟机卷数据源类型。

• 当source_type值是volume时，指卷的uuid。
• 当source_type值是snapshot时，指快照的uuid。
• 当source_type值是image时，指镜像的uuid。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

source_type

否

String

参数解释：

卷设备源头类型。

约束限制：

不涉及

取值范围：

当前只支持volume、image、snapshot、blank类型。

• volume：使用卷创建云服务器。
• image：使用镜像创建云服务器。
• snapshot：使用快照创建云服务器。
• blank：创建空数据卷。

默认取值：

不涉及

encrypted

否

Boolean

参数解释：

是否加密。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

cmk_id

否

String

参数解释：

密钥ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

volume_type

否

String

参数解释：

卷类型。

了解不同磁盘类型的详细信息，请参见磁盘类型及性能介绍。

约束限制：

当source_type取值为image，destination_type取值为volume时建议填写。

取值范围：

不涉及

默认取值：

不涉及

volume_size

否

Integer

参数解释：

卷大小。

约束限制：

不涉及

取值范围：

整数，单位为GiB。

默认取值：

不涉及

attachment

否

Object

参数解释：

磁盘接口。详情请参见表9。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

boot_index

否

Integer

参数解释：

启动标识。

约束限制：

当卷设备的源头类型全为volume时，boot_index的值有一个为0。

取值范围：

• “0”代表启动盘。
• “-1”代表非启动盘。不传该字段时默认取值为“-1”。

默认取值：

不涉及

delete_on_termination

否

Boolean

参数解释：

磁盘是否随实例一同释放。

约束限制：

不涉及

取值范围：

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

默认取值：

默认系统盘设置为true随实例释放，数据盘设置为false不随实例释放。

market_type

否

String

参数解释：

计费类型。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

spot_options

否

Object

参数解释：

spot实例相关参数。详情请参见表11。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

spot_price

否

Float

参数解释：

用户愿意为竞价实例每小时支付的最高价格。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

block_duration_minutes

否

Integer

参数解释：

购买的竞价实例时长。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

instance_interruption_behavior

否

String

参数解释：

竞价实例中断策略，当前支持immediate。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

publicip

否

Object

参数解释：

公网访问。详情请参见表13。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

publicip_type

否

String

参数解释：

弹性公网IP类型。

约束限制：

必须是系统具体支持的类型。

取值范围：

5_bgp（全动态BGP）、5_sbgp（静态BGP）、5_youxuanbgp（优选BGP）

默认取值：

不涉及

charging_mode

否

String

参数解释：

弹性公网IP计费类型。

约束限制：

不涉及

取值范围：

• prePaid：预付费，即包年包月。
• postPaid：后付费，即按需付费。

默认取值：

postPaid

bandwidth

否

Object

参数解释：

弹性公网IP带宽。详情请参见表14。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

delete_on_termination

否

Boolean

参数解释：

弹性公网IP是否随实例一同释放。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

share_type

否

String

参数解释：

带宽类型。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

size

否

integer

参数解释：

带宽大小。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

charge_mode

否

String

参数解释：

计费类型。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

id

否

String

参数解释：

带宽ID，创建WHOLE类型带宽的弹性IP时可以指定之前的共享带宽创建。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

tags

否

Array of Objects

参数解释：

标签。详情请参见表16。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

key

否

String

参数解释：

标签键。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

value

否

String

参数解释：

标签值。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

launch_template_id

String

参数解释：

模板ID。

取值范围：

不涉及