1. 接口描述
接口请求域名： cvm.api3.gsesgpucloud.com。
本接口（CreateLaunchTemplate）用于创建实例启动模板。
实例启动模板是一种配置数据并可用于创建实例，其内容包含创建实例所需的配置，比如实例类型，数据盘和系统盘的类型和大小，以及安全组等信息。
默认接口请求频率限制：20次/秒。
接口更新时间：2023-03-17 15:13:24。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：CreateLaunchTemplate |
| Version | 是 | 否 | String | 公共参数，本接口取值：2017-03-12 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| LaunchTemplateName | 是 | 否 | String | 实例启动模板名称。长度为2~128个英文或中文字符。 示例值： MyLaunchTemplate |
| Placement | 是 | 否 | Placement | 实例所在的位置。通过该参数可以指定实例所属可用区，所属项目，所属宿主机（在专用宿主机上创建子机时指定）等属性。 示例值：查看 |
| ImageId | 是 | 否 | String | 指定有效的镜像ID，格式形如img-xxx。镜像类型分为四种：：1.公共镜像2.自定义镜像3.共享镜像4.服务市场镜像；公共镜像、自定义镜像、共享镜像的镜像ID可通过登录控制台查询；服务镜像市场的镜像ID可通过云市场查询。通过调用接口 DescribeImages ，传入InstanceType获取当前机型支持的镜像列表，取返回信息中的ImageId字段。 示例值： img-dkwyg6sr |
| LaunchTemplateVersionDescription | 否 | 否 | String | 实例启动模板版本描述。长度为2~256个英文或中文字符。 示例值： MyLaunchTemplateVersionDesc |
| InstanceType | 是 | 否 | String | 实例机型。不同实例机型指定了不同的资源规格。 示例值： S5.16XLARGE256 |
| SystemDisk | 否 | 否 | SystemDisk | 实例系统盘配置信息。若不指定该参数，则按照系统默认值进行分配。 示例值：查看 |
| DataDisks | 否 | 否 | Array of DataDisk | 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 | 否 | 否 | Int64 | 购买实例数量。包年包月实例取值范围：[1，300]，按量计费实例取值范围：[1，100]。默认取值：1。指定购买实例的数量不能超过用户所能购买的剩余配额数量，具体配额相关限制详见CVM实例购买限制。 示例值： 1 |
| InstanceName | 否 | 否 | String | 实例显示名称。 示例值： MyInstance |
| LoginSettings | 否 | 否 | LoginSettings | 实例登录设置。通过该参数可以设置实例的登录方式密码、密钥或保持镜像的原始登录设置。默认情况下会随机生成密码，并以站内信方式知会到用户。 示例值：查看 |
| SecurityGroupIds | 否 | 否 | Array of String | 实例所属安全组。该参数可以通过调用 DescribeSecurityGroups 的返回值中的sgId字段来获取。若不指定该参数，则绑定默认安全组。 示例值： ["sg-rf6ogz49"] |
| EnhancedService | 否 | 否 | EnhancedService | 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数，则默认公共镜像开启云监控、云安全服务；自定义镜像与镜像市场镜像默认不开启云监控，云安全服务，而使用镜像里保留的服务。 示例值：查看 |
| ClientToken | 否 | 否 | String | 用于保证请求幂等性的字符串。该字符串由客户生成，需保证不同请求之间唯一，最大值不超过64个ASCII字符。若不指定该参数，则无法保证请求的幂等性。 示例值： 12dasfa423fdasq5twerra |
| HostName | 否 | 否 | String | 云服务器的主机名点号（.）和短横线（-）不能作为 HostName 的首尾字符，不能连续使用。Windows 实例：名字符长度为[2, 15]，允许字母（不限制大小写）、数字和短横线（-）组成，不支持点号（.），不能全是数字。其他类型（Linux 等）实例：字符长度为[2, 60]，允许支持多个点号，点之间为一段，每段允许字母（不限制大小写）、数字和短横线（-）组成。 示例值： zhangsan |
| ActionTimer | 否 | 否 | Datetime | 定时任务。通过该参数可以为实例指定定时任务，目前仅支持定时销毁。 示例值： 2014-08-03 12:00:00 |
| DisasterRecoverGroupIds | 否 | 否 | Array of String | 置放群组id，仅支持指定一个。 示例值： ["ps-3p88qhfo"] |
| TagSpecification | 否 | 否 | Array of TagSpecification | 标签描述列表。通过指定该参数可以同时绑定标签到相应的资源实例，当前仅支持绑定标签到云服务器实例。 示例值：查看 |
| UserData | 否 | 否 | String | 提供给实例使用的用户数据，需要以 base64 方式编码，支持的最大数据大小为 16KB。 示例值： YmFzZTY0Cg== |
| CamRoleName | 否 | 否 | String | CAM角色名称。可通过DescribeRoleList接口返回值中的roleName获取。 示例值： roleName001 |
| HpcClusterId | 否 | 否 | String | 高性能计算集群ID。若创建的实例为高性能计算实例，需指定实例放置的集群，否则不可指定。 示例值： hpc-a5n666lo |
| InstanceChargeType | 否 | 否 | String | 实例计费类型。 示例值： PREPAID |
| InstanceChargePrepaid | 否 | 否 | InstanceChargePrepaid | 预付费模式，即包年包月相关参数设置。通过该参数可以指定包年包月实例的购买时长、是否设置自动续费等属性。若指定实例的付费模式为预付费则该参数必传。 示例值：查看 |
| DisableApiTermination | 否 | 否 | Bool | 实例销毁保护标志，表示是否允许通过api接口删除实例。取值范围： 默认取值：FALSE。 示例值： false |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| LaunchTemplateId | String | 当通过本接口来创建实例启动模板时会返回该参数，表示创建成功的实例启动模板ID。 示例值： lt-a5n125lo |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| AccountQualificationRestrictions | 该请求账户未通过资格审计。 |
| FailedOperation.DisasterRecoverGroupNotFound | 未找到指定的容灾组 |
| FailedOperation.InquiryPriceFailed | 询价失败 |
| FailedOperation.NoAvailableIpAddressCountInSubnet | 子网可用IP已耗尽。 |
| FailedOperation.SnapshotSizeLargerThanDataSize | 快照容量大于磁盘大小，请选用更大的磁盘空间。 |
| InternalError | 内部错误 |
| InvalidParameterValueLimit | 参数值数量超过限制。 |
| InvalidParameterCombination | 表示参数组合不正确。 |
| InvalidParameter.ValueTooLarge | 参数长度超过限制。 |
| VpcAddrNotInSubNet | 私有网络ip不在子网内。 |
| InvalidInstanceType.Malformed | 指定InstanceType参数格式不合法。 |
| InvalidClientToken.TooLong | 指定的ClientToken字符串长度超出限制，必须小于等于64字节。 |
| InvalidImageOsType.Unsupported | 不支持的操作系统类型。 |
| InvalidParameter.InvalidIpFormat | 指定的私有网络ip格式不正确。 |
| ImageQuotaLimitExceeded | 镜像配额超过了限制。 |
| InvalidCloudDisk.SoldOut | 云磁盘售罄。 |
| SecGroupActionFailure | 安全组服务接口调用通用错误。 |
| FailedOperation.NoAvailableInstanceType | 没有可用的实例类型。 |