CreateModel（创建实例启动模版）
实例启动模板中可以储存除密码外的任意创建实例配置信息，例如实例所属地域、镜像ID、套餐规格、安全组ID和公网带宽等。如果模板中没有指定某一实例配置，您需要在创建实例时为实例指定该配置。
注意事项
- 每个账号下每个region最多拥有50个实例启动模板
- 在创建实例模板时，弹性IP仅支持自动分配
- 模板一旦创建，不支持修改，如修改配置参数需要创建新模板
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（返回值）
| 名称 | 类型 | 是否可缺省 | 示例值 | 描述 |
|---|---|---|---|---|
| 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"
}
文档内容是否对您有帮助？
根本没帮助
文档较差
文档一般
文档不错
文档很好
在文档使用中是否遇到以下问题
内容不全，不深入
内容更新不及时
描述不清晰，比较混乱
系统或功能太复杂，缺乏足够的引导
内容冗长
更多建议
0/200
评价建议不能为空
提交成功！
非常感谢您的反馈，我们会继续努力做到更好！