创建实例启动模板

最近更新时间:2019-11-05 15:30:12

CreateModel(创建实例启动模版)

实例启动模板中包含用于创建实例的相关配置,例如实例所属地域、镜像ID、套餐规格、安全组ID和公网带宽等。如果模板中没有指定某一实例配置,您需要在创建实例时为实例指定该配置。

注意事项

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

Request Parameters(请求参数)

ImageId

  • 镜像ID
  • 类型: String
  • 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  • 是否可缺省: 否

InstanceType

  • 实例套餐类型,如果调用时未指定实例套餐类型,默认值为I1.1A
  • 类型: String
  • 有效值:

    • IO优化型I1:I1.1A | I1.1B| I1.1C| I1.2A| I1.2B| I1.2C| I1.4A| I1.4B| I1.4C| I1.8A| I1.8B| I1.8C| I1.16A| I1.16B| I1.16C| I1.24A| I1.24B| I1.24C| I1.24D| I1.32A| I1.32B;
    • IO优化型I2:I2.1A| I2.1B | I2.1C | I2.2B | I2.2C | I2.4B | I2.4C | I2.8B | I2.8C | I2.16B | I2.16C | I2.24B | I2.24C | I2.32B | I2.32C
    • IO优化型I3:I3.2B | I3.2C | I3.4B | I3.4C | I3.4D | I3.8B | I3.8C| I3.8D | I3.12B | I3.12C |I3.16B | I3.16C | I3.24B | I3.24C | I3.32B | I3.32E
    • 计算优化型C1:C1.1A | C1.1B| C1.1C| C1.2A| C1.2B| C1.2C| C1.4A| C1.4B| C1.4C|C1.8A| C1.8B| C1.8C| C1.16A| C1.16B| C1.16C| C1.24A| C1.24B| C1.24C| C1.24D| C1.32A| C1.32B
    • 计算优化型C3: C3.4B| C3.4C| C3.8B| C3.8C| C3.16B| C3.16C| C3.32B | C3.32E
    • 标准型S3:S3.1A | S3.1B| S3.1C| S3.2A| S3.2B| S3.2C| S3.4A| S3.4B| S3.4C| S3.4D |S3.8A| S3.8B| S3.8C| S3.8D| S3.12B| S3.12C| S3.16A| S3.16B| S3.16C| S3.24B| S3.24C| S3.32B| S3.32E
    • 通用型N3:N3.2B | N3.2C | N3.4B |N3.4C | N3.4D | N3.8B | N3.8C| N3.8D | N3.12B |N3.12C |N3.16B | N3.16C | N3.24B | N3.24C | N3.32B | N3.32E
    • GPU通用计算性(P3): P3.56C4| P3.56B2| P3.28A1
    • GPU通用计算型(P3I):P3I.28C2|P3I.14B1
    • GPU通用计算型(P4V): P4V.56D8|P4V.28C4|P4V.16B2|P4V.8A1
    • GPU推理计算型(P3IN):P3IN.32D4|P3IN.16C2|P3IN.8B1|P3IN.4A1

    具体套餐信息参考 实例套餐类型定义

  • 是否可缺省: 是

SystemDisk

  • 云主机系统盘配置参数。若不指定该参数,则按照系统默认值进行分配。通用型N2、N3主机支持更换操作系统时指定系统盘大小。
  • 类型:SystemDisk
  • 是否可缺省:是

DataDiskGb

  • 数据卷容量,单位GB,容量限制依据 实例套餐类型定义 变化,如果调用时未指定,则为相应实例套餐类型最小值。InstanceType为通用型主机时,此参数不生效。
  • 类型: Integer
  • 是否可缺省: 是

DataDisk.n.Type

  • 数据盘(云盘)的类型,数据盘n的类型,n 的取值范围为 [1, 8]。只支持I2、I2联网增强、N1、N2、N3、S3和I3。DataDisk.n.Type与DataDisk.n.Size必须都填写才有效。
  • 类型:String
  • 有效值: SSD3.0,EHDD
  • 是否可缺省:是

DataDisk.n.Size

  • 第 n 个数据盘(云盘)的容量大小,n 的取值范围为 [1, 8]。只支持I2、I2联网增强、N1、N2、N3、S3和I3。DataDisk.n.Type与DataDisk.n.Size必须都填写才有效。
  • 类型:Integer
  • 有效值: [10,16000]
  • 是否可缺省:是

SubnetId

  • VPC环境下的子网ID,绑定到主网卡
  • 类型: String
  • 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  • 是否可缺省: 否

InstancePassword

  • 实例开机密码
  • 类型: String
  • 有效值:最短8字符,最长32字符,必须包含大小写英文字符和数字,支持其他可见字符
  • 是否可缺省: 是

KeepImageLogin

  • 保留镜像设置登录。该参数只对使用自定义镜像有效。当该值填写为true,默认InstancePassword参数无效。该参数与InstancePassword必须填写一个。
  • 类型:Boolean
  • 有效值:true | false
  • 默认值:false
  • 是否可以缺省:是

ChargeType

  • 计费类型,调用时需要明确指定,无默认值
  • 类型: String
  • 有效值:Monthly(包年包月)、Daily(按日月结)、 HourlyInstantSettlement(按小时实时结算)
  • 是否可缺省: 否

PurchaseTime

  • 购买时长,单位月
  • 类型: Integer
  • 有效值:当计费类型为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

  • 私有IP地址,指定子网IP地址范围内的任意有效值,代表实例的主IP地址,只能选择一个,绑定到主网卡;如果未指定该参数,系统自动从有效地址池中随机选取一个
  • 类型: String
  • 有效值:标准IP地址格式
  • 是否可缺省: 是

InstanceName

  • 实例名称,如果未指定,则自动生成,形如KSC-IN-[A-Z0-9]{10}
  • 类型: String
  • 有效值:最短2字符,最长64字符,支持中英文
  • 是否可缺省: 是

InstanceNameSuffix

  • 实例名称后缀,InstanceName参数如果缺省,此参数不生效;当大于1台的批量创建主机,后缀编号自动+1,例如后缀输入5,主机名输入"host",批量3台,则生成的三台主机名分别为:"host-5"、"host-6"、"host-7";
  • 类型: String
  • 默认值:空
  • 有效值:0到9999
  • 是否可缺省: 是

SriovNetSupport 联网增强属性

  • 该参数需要满足以下两个条件:
    1. IO优化型I1,计算优化型C1,IO优化型I2的8C以上套餐
    2. 使用的是金山云提高的标准镜像或者通过金山云标准镜像开机的实例再制作的自定义镜像
  • 默认值:false
  • 类型:Boolean
  • 是否可缺省:是

ProjectId

  • 实例所属项目ID
  • 类型:long
  • 有效值:账户有权限的项目ID,0为默认项目
  • 是否可缺省:是
  • 默认值:默认项目

DataDisk.n.DeleteWithInstance

  • 数据盘是否随实例释放
  • 类型:Boolean
  • 有效值:
    • true:实例释放时,这块磁盘随实例一起释放。
    • false:实例释放时,这块磁盘保留不释放。
  • 是否可缺省:是
  • 默认值:false

DataGuardId

  • 容灾分组ID
  • 类型:String
  • 是否可缺省:是

KeyId

  • 秘钥ID,非必填项,无默认值,若填写则默认InstancePassword参数无效,当用户选择other-linux镜像时,不支持该登录方式。若使用的自定义镜像,KeepImageLogin 为true时,默认keyId和InstancePassword参数无效。
  • 类型:String
  • 是否可缺省:是

AddressBandWidth

  • 弹性IP的带宽
  • 类型: Integer
  • 是否可缺省: 是,购买弹性IP时不可缺省

LineId

  • 弹性IP的链路类型的ID
  • 类型: String
  • 是否可缺省: 是,购买弹性IP时不可缺省

AddressChargeType

  • 弹性IP的计费类型
  • 类型: String
  • 有效值: PrePaidByMonth :包年包月,有到期时间,只能升带宽 PostPaidByPeak:按峰值月结,无到期时间,可升降带宽 PostPaidByDay:按日月结,无到期时间,可升降带宽 PostPaidByTransfer:按流量月结,无到期时间,可升降带宽 PostPaidByHour:按小时月结,无到期时间,可升降带宽
  • 是否可缺省: 是,购买弹性IP时不可缺省

AddressPurchaseTime

  • 弹性IP的购买时长,只有购买包年包月弹性IP时不可缺省。
  • 类型: Integer
  • 是否可缺省: 是

AddressProjectId

  • 弹性IP项目的ID
  • 类型: String
  • 是否可缺省: 是
  • 缺省值: 默认项目

ModelName

  • 实例启动模版名称,不允许重复
  • 类型: String
  • 是否可缺省: 否

Response Elements(返回值)

RequestId

  • 请求ID
  • 类型: String
  • 是否可缺省: 否

ModelId

  • 实例启动模板ID
  • 类型:String
  • 是否可缺省: 否

ModelName

  • 实例启动模板名称
  • 类型:String
  • 是否可缺省: 否

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"
}

金山云,开启您的云计算之旅

注册有礼