全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

创建实例启动模板

最近更新时间:2023-09-07 19:35:52

CreateModel(创建实例启动模版)

实例启动模板中可以储存除密码外的任意创建实例配置信息,例如实例所属地域、镜像ID、套餐规格、安全组ID和公网带宽等。如果模板中没有指定某一实例配置,您需要在创建实例时为实例指定该配置。

注意事项

  1. 每个账号下每个region最多拥有50个实例启动模板
  2. 在创建实例模板时,弹性IP仅支持自动分配
  3. 模板一旦创建,不支持修改,如修改配置参数需要创建新模板

Request Parameters(请求参数)

名称 类型
是否可缺省
示例值 有效值 描述
Action String CreateModel - 系统规定参数。取值:CreateModel
ImageId String 13536cc1-0dbd-4741-87d3-f7abbb0db329 标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 镜像ID
InstanceType String C1.1B 实例套餐类型有效值
具体套餐信息参考实例套餐类型定义
实例套餐类型,如果调用时未指定实例套餐类型,默认值为I1.1A
SystemDisk SystemDisk - - 云主机系统盘配置参数。若不指定该参数,则按照系统默认值进行分配。通用型N2、N3主机支持更换操作系统时指定系统盘大小。
DataDiskGb Integer - - 数据卷容量,单位GB,容量限制依据实例套餐类型定义变化,如果调用时未指定,则为相应实例套餐类型最小值。InstanceType为通用型主机时,此参数不生效。
SubnetId String - 标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ VPC环境下的子网ID,绑定到主网卡。
DataDisk.N.Type String - SSD3.0,EHDD 数据盘(云盘)的类型,数据盘n的类型,n 的取值范围为 [1, 8]。只支持I2、I2联网增强、N1、N2、N3、S3和I3。DataDisk.n.Type与DataDisk.n.Size必须都填写才有效。
DataDisk.N.Size Integer 20 [10,16000] 第 n 个数据盘(云盘)的容量大小,n 的取值范围为 [1, 8]。只支持I2、I2联网增强、N1、N2、N3、S3和I3。DataDisk.n.Type与DataDisk.n.Size必须都填写才有效。
KeepImageLogin Boolean - true/false,默认值为false 保留镜像设置登录。该参数只对使用自定义镜像有效。当该值填写为true,默认InstancePassword参数无效。该参数与InstancePassword必须填写一个。
KeyId String - - 秘钥ID,非必填项,无默认值,若填写则默认InstancePassword参数无效,当用户选择other-linux镜像时,不支持该登录方式。若使用的自定义镜像,KeepImageLogin 为true时,默认keyId和InstancePassword参数无效。
ChargeType String - Monthly(包年包月)、Daily(按量付费(按日月结))、 HourlyInstantSettlement(按量付费)、Spot(竞价型实例) 计费类型,调用时需要明确指定,无默认值。
PurchaseTime Integer 1 当计费类型为Monthly(包年包月)时,有效值1-36;其他计费类型时,强制要求参数值为0。 购买时长,单位月。
SecurityGroupId String列表 - 标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 实例绑定的安全组,目前仅支持绑定一个安全组。
PrivateIpAddress String - 标准IP地址格式 私有IP地址,指定子网IP地址范围内的任意有效值,代表实例的主IP地址,只能选择一个,绑定到主网卡;如果未指定该参数,系统自动从有效地址池中随机选取一个。
InstanceName String test_2 最短2字符,最长64字符,支持中英文 实例名称,如果未指定,则自动生成,形如KSC-IN-[A-Z0-9]{10}
InstanceNameSuffix String 1 0到9999,默认值为空 实例名称后缀,InstanceName参数如果缺省,此参数不生效;当大于1台的批量创建主机,后缀编号自动+1,例如后缀输入5,主机名输入"host",批量3台,则生成的三台主机名分别为:“host-5”、“host-6”、“host-7”。
SriovNetSupport String - - 联网增强属性
该参数需要满足以下两个条件:
1.IO优化型I1,计算优化型C1,IO优化型I2的8C以上套餐
2.使用的是金山云提高的标准镜像或者通过金山云标准镜像开机的实例再制作的自定义镜像
ProjectId long - 账户有权限的项目ID,0为默认项目,默认值为默认项目 实例所属项目ID
DataDisk.n.DeleteWithInstance Boolean - true:实例释放时,这块磁盘随实例一起释放。
false:实例释放时,这块磁盘保留不释放。
数据盘是否随实例释放,默认值为false
DataGuardId String - - 容灾分组ID
AddressBandWidth Integer 是,购买弹性IP时不可缺省 - - 弹性IP的带宽
LineId String 是,购买弹性IP时不可缺省 - - 弹性IP的链路类型的ID
AddressChargeType String 是,购买弹性IP时不可缺省 - Monthly:包年包月,有到期时间,只能升带宽
Peak:按量付费(月峰值),无到期时间,可升降带宽
Daily:按量付费(按日月结),无到期时间,可升降带宽
TrafficMonthly:按量付费(流量月结),无到期时间,可升降带宽
DailyPaidByTransfer:按量付费(流量),无到期时间,可升降带宽
HourlyInstantSettlement:按量付费,无到期时间,可升降带宽
弹性IP的计费类型
AddressPurchaseTime Integer - - 弹性IP的购买时长,只有购买包年包月弹性IP时不可缺省。
AddressProjectId String 是,缺省值为默认项目 - - 弹性IP项目的ID
ModelName String - ModelTest001 实例启动模版名称,不允许重复

Response Elements(返回值)

::: hljs-center

名称 类型 是否可缺省 示例值 描述
RequestId String 8221fbe8-43ec-4c48-9b51-ab6ff17f4020001 请求ID
ModelId String bb9355dd-c72e-4b8f-a1dd-490d7a1e42c5 实例启动模板ID
ModelName String ModelTest001 实例启动模板名称
IamRoleName String - 实例待绑定的IAM角色名称

Examples(例子)

在cn-beijing-6这个region,创建一个实例启动模板,实例套餐类型N3.2B,计费类型包年包月,购买时长一个月,启动模板名称为ModelTest001。

Sample Request(请求)
http://kec.cn-beijing-6.api.ksyun.com/?Action=CreateModel&Version=2016-03-04
&InstanceType=N3.2B
&MaxCount=1
&MinCount=1
&ImageId=d3290df6-3597-4f83-b5ae-48356e91ad46
&SubnetId=68427c63-7940-4e01-ab9c-ff6ad79d98ac
&InstanceName=csg_test01
&SecurityGroupId=128fbf47-5860-4094-bf59-c76017f62bd8
&ChargeType=Monthly
&InstanceNameSuffix=1
&SystemDisk.DiskType=SSD3.0
&SystemDisk.DiskSize=20
&PurchaseTime=1
&ModelName=ModelTest001
Sample Response(返回)
{
    "RequestId":"a4d2428c-a4b9-46a5-9a44-3c4f333abe09004",
    "ModelId":"bb9355dd-c72e-4b8f-a1dd-490d7a1e42c5",
    "ModelName":"ModelTest001"
}
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈