1. 接口描述
接口请求域名: cvm.tencentcloudapi.com 。
本接口(CreateLaunchTemplate)用于创建实例启动模板。
实例启动模板是一种配置数据并可用于创建实例,其内容包含创建实例所需的配置,比如实例类型,数据盘和系统盘的类型和大小,以及安全组等信息。
初次创建实例模板后,其模板版本为默认版本1,新版本的创建可使用 CreateLaunchTemplateVersion 创建,版本号递增。默认情况下,在RunInstances 中指定实例启动模板,若不指定模板版本号,则使用默认版本。
默认接口请求频率限制:20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:CreateLaunchTemplate。 |
Version | 是 | String | 公共参数,本接口取值:2017-03-12。 |
Region | 是 | String | 公共参数,详见产品支持的 地域列表。 |
LaunchTemplateName | 是 | String | 实例启动模板名称。长度为2~128个英文或中文字符。 示例值:MyLaunchTemplate |
Placement | 是 | Placement | 实例所在的位置。通过该参数可以指定实例所属可用区,所属项目,所属宿主机(在专用宿主机上创建子机时指定)等属性。 |
ImageId | 是 | String | 指定有效的镜像ID,格式形如img-xxx 。镜像类型分为四种:可通过以下方式获取可用的镜像ID: 公共镜像 、自定义镜像 、共享镜像 的镜像ID可通过登录控制台查询;服务镜像市场 的镜像ID可通过云市场查询。ImageId 字段。示例值:img-dkwyg6sr |
LaunchTemplateVersionDescription | 否 | String | 实例启动模板版本描述。长度为2~256个英文或中文字符。 示例值:MyLaunchTemplateVersionDesc |
InstanceType | 否 | String | 实例机型。不同实例机型指定了不同的资源规格。 示例值:S5.16XLARGE256 |
SystemDisk | 否 | SystemDisk | 实例系统盘配置信息。若不指定该参数,则按照系统默认值进行分配。 |
DataDisks.N | 否 | Array of DataDisk | 实例数据盘配置信息。若不指定该参数,则默认不购买数据盘。支持购买的时候指定21块数据盘,其中最多包含1块LOCAL_BASIC数据盘或者LOCAL_SSD数据盘,最多包含20块CLOUD_BASIC数据盘、CLOUD_PREMIUM数据盘或者CLOUD_SSD数据盘。 |
VirtualPrivateCloud | 否 | VirtualPrivateCloud | 私有网络相关信息配置。通过该参数可以指定私有网络的ID,子网ID等信息。若不指定该参数,则默认使用基础网络。若在此参数中指定了私有网络IP,即表示每个实例的主网卡IP;同时,InstanceCount参数必须与私有网络IP的个数一致且不能大于20。 |
InternetAccessible | 否 | InternetAccessible | 公网带宽相关信息设置。若不指定该参数,则默认公网带宽为0Mbps。 |
InstanceCount | 否 | Integer | 购买实例数量。包年包月实例取值范围:[1,300],按量计费实例取值范围:[1,100]。默认取值:1。指定购买实例的数量不能超过用户所能购买的剩余配额数量,具体配额相关限制详见CVM实例购买限制。 示例值:1 |
InstanceName | 否 | String | 实例显示名称。{R:x} ,表示生成数字[x, x+n-1] ,其中n 表示购买实例的数量,例如server_{R:3} ,购买1台时,实例显示名称为server_3 ;购买2台时,实例显示名称分别为server_3 ,server_4 。支持指定多个模式串{R:x} 。1、2...n ,其中n 表示购买实例的数量,例如server_ ,购买2台时,实例显示名称分别为server_1 ,server_2 。示例值:MyInstance |
LoginSettings | 否 | LoginSettings | 实例登录设置。通过该参数可以设置实例的登录方式密码、密钥或保持镜像的原始登录设置。默认情况下会随机生成密码,并以站内信方式知会到用户。 |
SecurityGroupIds.N | 否 | Array of String | 实例所属安全组。该参数可以通过调用 DescribeSecurityGroups 的返回值中的sgId字段来获取。若不指定该参数,则绑定默认安全组。 示例值:["sg-rf6ogz49"] |
EnhancedService | 否 | EnhancedService | 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数,则默认公共镜像开启云监控、云安全服务;自定义镜像与镜像市场镜像默认不开启云监控,云安全服务,而使用镜像里保留的服务。 |
ClientToken | 否 | String | 用于保证请求幂等性的字符串。该字符串由客户生成,需保证不同请求之间唯一,最大值不超过64个ASCII字符。若不指定该参数,则无法保证请求的幂等性。 |
HostName | 否 | String | 云服务器的主机名。 |
ActionTimer | 否 | ActionTimer | 定时任务。通过该参数可以为实例指定定时任务,目前仅支持定时销毁。 |
DisasterRecoverGroupIds.N | 否 | Array of String | 置放群组id,仅支持指定一个。 示例值:["ps-3p88qhfo"] |
TagSpecification.N | 否 | Array of TagSpecification | 标签描述列表。通过指定该参数可以同时绑定标签到相应的资源实例,当前仅支持绑定标签到云服务器实例。 |
InstanceMarketOptions | 否 | InstanceMarketOptionsRequest | 实例的市场相关选项,如竞价实例相关参数,若指定实例的付费模式为竞价付费则该参数必传。 |
UserData | 否 | String | 提供给实例使用的用户数据,需要以 base64 方式编码,支持的最大数据大小为 16KB。关于获取此参数的详细介绍,请参阅Windows和Linux启动时运行命令。 示例值:YmFzZTY0Cg== |
DryRun | 否 | Boolean | 是否只预检此次请求。 true:发送检查请求,不会创建实例。检查项包括是否填写了必需参数,请求格式,业务限制和云服务器库存。 如果检查不通过,则返回对应错误码; 如果检查通过,则返回RequestId. false(默认):发送正常请求,通过检查后直接创建实例。 示例值:false |
CamRoleName | 否 | String | CAM角色名称。可通过DescribeRoleList 接口返回值中的roleName 获取。示例值:testroleName001 |
HpcClusterId | 否 | String | 高性能计算集群ID。若创建的实例为高性能计算实例,需指定实例放置的集群,否则不可指定。 示例值:hpc-a5n666lo |
InstanceChargeType | 否 | String | 实例计费类型。 示例值:PREPAID |
InstanceChargePrepaid | 否 | InstanceChargePrepaid | 预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月实例的购买时长、是否设置自动续费等属性。若指定实例的付费模式为预付费则该参数必传。 |
DisableApiTermination | 否 | Boolean | 实例销毁保护标志,表示是否允许通过api接口删除实例。取值范围: 示例值:false |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
LaunchTemplateId | String | 当通过本接口来创建实例启动模板时会返回该参数,表示创建成功的实例启动模板ID 。示例值:lt-a5n123lo |
RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 使用最简单参数创建实例启动模板
只传必传的Zone、镜像ID和启动模板ID,其他均采用系统默认值,具体配置如下:实例所在位置为广州二区,镜像ID为:img-pmqg1cw7,实例启动模板名称:test
输入示例
POST / HTTP/1.1
Host: cvm.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateLaunchTemplate
<公共请求参数>
{
"LaunchTemplateName": "test",
"Placement": {
"Zone": "ap-guangzhou-2"
},
"ImageId": "img-pmqg1cw7"
}
输出示例
{
"Response": {
"LaunchTemplateId": "lt-lobxe2yo",
"RequestId": "9b4ad85f-1657-4445-111d-3c0a9fbec309"
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
AccountQualificationRestrictions | 该请求账户未通过资格审计。 |
AuthFailure.CamRoleNameAuthenticateFailed | 角色名鉴权失败 |
FailedOperation.DisasterRecoverGroupNotFound | 未找到指定的容灾组 |
FailedOperation.InquiryPriceFailed | 询价失败 |
FailedOperation.NoAvailableIpAddressCountInSubnet | 子网可用IP已耗尽。 |
FailedOperation.SecurityGroupActionFailed | 安全组操作失败。 |
FailedOperation.SnapshotSizeLargerThanDataSize | 快照容量大于磁盘大小,请选用更大的磁盘空间。 |
FailedOperation.TagKeyReserved | 请求中指定的标签键为系统预留标签,禁止创建 |
InstancesQuotaLimitExceeded | 表示当前创建的实例个数超过了该账户允许购买的剩余配额数。 |
InternalError.TradeUnknownError | 内部错误 |
InvalidAccount.InsufficientBalance | 账户余额不足。 |
InvalidClientToken.TooLong | 指定的ClientToken字符串长度超出限制,必须小于等于64字节。 |
InvalidHostId.Malformed | 无效CDH ID 。指定的CDH ID 格式错误。例如ID 长度错误host-1122 。 |
InvalidHostId.NotFound | 指定的HostId不存在,或不属于该请求账号所有。 |
InvalidImageId.Malformed | 错误的镜像Id格式。 |
InvalidImageId.NotFound | 未找到该镜像。 |
InvalidInstanceName.TooLong | 指定的InstanceName字符串长度超出限制,必须小于等于60字节。 |
InvalidInstanceType.Malformed | 指定InstanceType参数格式不合法。 |
InvalidParameter.InstanceImageNotSupport | 当前接口不支持实例镜像。 |
InvalidParameter.InternetAccessibleNotSupported | 不支持设置公网带宽相关信息。 |
InvalidParameter.InvalidIpFormat | 指定的私有网络ip格式不正确。 |
InvalidParameter.LackCoreCountOrThreadPerCore | CoreCount和ThreadPerCore必须同时提供。 |
InvalidParameter.PasswordNotSupported | 不支持设置登录密码。 |
InvalidParameter.SnapshotNotFound | 指定的快照不存在。 |
InvalidParameterCombination | 表示参数组合不正确。 |
InvalidParameterValue | 参数取值错误。 |
InvalidParameterValue.CloudSsdDataDiskSizeTooSmall | SSD云硬盘为数据盘时,购买大小不得小于100GB |
InvalidParameterValue.CoreCountValue | 核心计数不合法。 |
InvalidParameterValue.IllegalHostName | HostName参数值不合法 |
InvalidParameterValue.InstanceTypeNotSupportHpcCluster | 实例类型不可加入高性能计算集群。 |
InvalidParameterValue.InstanceTypeRequiredHpcCluster | 高性能计算实例需指定对应的高性能计算集群。 |
InvalidParameterValue.InsufficientOffering | 竞价数量不足。 |
InvalidParameterValue.InsufficientPrice | 竞价失败。 |
InvalidParameterValue.InvalidAppIdFormat | 无效的appid。 |
InvalidParameterValue.InvalidImageForGivenInstanceType | 镜像ID不支持指定的实例机型。 |
InvalidParameterValue.InvalidImageId | 镜像不允许执行该操作 |
InvalidParameterValue.InvalidImageState | 镜像被其他操作占用,请检查,并稍后重试。 |
InvalidParameterValue.InvalidIpFormat | IP地址不符合规范 |
InvalidParameterValue.InvalidLaunchTemplateDescription | 实例启动模板描述格式错误。 |
InvalidParameterValue.InvalidLaunchTemplateName | 实例启动模板名称格式错误。 |
InvalidParameterValue.InvalidLaunchTemplateVersionDescription | 实例启动模板描述格式错误。 |
InvalidParameterValue.InvalidPassword | 无效密码。指定的密码不符合密码复杂度限制。例如密码长度不符合限制等。 |
InvalidParameterValue.InvalidTimeFormat | 时间格式不合法。 |
InvalidParameterValue.InvalidUserDataFormat | UserData格式错误, 需要base64编码格式 |
InvalidParameterValue.LimitExceeded | 参数值数量超过限制。 |
InvalidParameterValue.MustDhcpEnabledVpc | 参数值必须为开启DHCP的VPC |
InvalidParameterValue.Range | 无效参数值。参数值取值范围不合法。 |
InvalidParameterValue.SnapshotIdMalformed | 快照ID不合要求,请提供规范的快照ID,类似snap-xxxxxxxx,字母x代表小写字符或者数字 |
InvalidParameterValue.SubnetNotExist | 创建失败,您指定的子网不存在,请您重新指定 |
InvalidParameterValue.ThreadPerCoreValue | 每核心线程数不合法。 |
InvalidParameterValue.VpcIdMalformed | VPC IDxxx 不合要求,请提供规范的Vpc ID, 类似vpc-xxxxxxxx,字母x代表小写字符或者数字。 |
InvalidParameterValue.VpcIdNotExist | 指定的VpcId不存在。 |
InvalidParameterValue.VpcIdZoneIdNotMatch | VPC网络与实例不在同一可用区 |
InvalidParameterValue.ZoneNotSupported | 请求不支持该可用区 |
InvalidPassword | 无效密码。指定的密码不符合密码复杂度限制。例如密码长度不符合限制等。 |
InvalidPeriod | 无效时长。目前只支持时长:[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 24, 36],单位:月。 |
InvalidPermission | 账户不支持该操作。 |
InvalidProjectId.NotFound | 无效的项目ID,指定的项目ID不存在。 |
InvalidSecurityGroupId.NotFound | 指定的安全组ID 不存在。 |
InvalidZone.MismatchRegion | 指定的zone 不存在。 |
LimitExceeded.InstanceQuota | 当前配额不足够生产指定数量的实例 |
LimitExceeded.LaunchTemplateQuota | 实例启动模板数量超限。 |
LimitExceeded.SingleUSGQuota | 安全组限额不足 |
LimitExceeded.SpotQuota | 竞价实例类型配额不足 |
LimitExceeded.UserSpotQuota | 竞价实例配额不足 |
LimitExceeded.VpcSubnetNum | 子网IP不足 |
MissingParameter | 缺少参数错误。 |
MissingParameter.DPDKInstanceTypeRequiredVPC | DPDK实例机型要求VPC网络 |
MissingParameter.MonitorService | 该实例类型必须开启云监控服务 |
ResourceInsufficient.AvailabilityZoneSoldOut | 该可用区已售罄 |
ResourceInsufficient.CloudDiskSoldOut | 指定的云盘规格已售罄 |
ResourceInsufficient.CloudDiskUnavailable | 云盘参数不符合规范 |
ResourceInsufficient.DisasterRecoverGroupCvmQuota | 实例个数超过容灾组的配额 |
ResourceInsufficient.SpecifiedInstanceType | 指定的实例类型库存不足。 |
ResourceNotFound.HpcCluster | 高性能计算集群不存在。 |
ResourceNotFound.KeyPairNotFound | 指定密钥对不存在。 |
ResourceNotFound.NoDefaultCbs | 无可用的缺省类型的CBS资源。 |
ResourceNotFound.NoDefaultCbsWithReason | 无可用的缺省类型的CBS资源。 |
ResourceUnavailable.InstanceType | 该可用区不售卖此机型 |
ResourcesSoldOut.EipInsufficient | 公网IP已售罄。 |
ResourcesSoldOut.SpecifiedInstanceType | 指定的实例类型已售罄。 |
UnsupportedOperation.BandwidthPackageIdNotSupported | 指定的实例付费模式或者网络付费模式不支持共享带宽包 |
UnsupportedOperation.InstanceTypeNotSupportJumboFrame | 实例类型不支持设置EnableJumboFrame 状态 |
UnsupportedOperation.InvalidDisk | 不支持指定的磁盘 |
UnsupportedOperation.KeyPairUnsupportedWindows | 密钥不支持Windows操作系统 |
UnsupportedOperation.NoInstanceTypeSupportSpot | 该实例类型不支持竞价计费 |
UnsupportedOperation.NotSupportImportInstancesActionTimer | 针对当前实例设置定时任务失败。 |
UnsupportedOperation.OnlyForPrepaidAccount | 该操作仅支持预付费账户 |
VpcAddrNotInSubNet | 私有网络ip不在子网内。 |
VpcIpIsUsed | 私有网络ip已经被使用。 |