创建实例

最近更新时间:2018-08-03 18:03:02

RunInstances(创建实例)

从有访问权限的镜像(image)启动指定数量的实例。 在启动实例时,实例属于“创建中”(pending)状态,在实例准备好时,会进入“运行中(running)”状态。

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;
    • 计算优化型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
    • 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

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

  • 是否可缺省: 是

DataDiskGb

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

MaxCount

  • 最大实例数,如果指定的实例数大于金山云在本人Region所能创建的最大实例数,则会创建大于MinCount数量的最大允许实例数。
  • 类型: Integer
  • 有效值: 最小值1,最大值为MIN(当前用户实例剩余配额,30),即用户剩余配额和100比较的小者
  • 是否可缺省: 否

MinCount

  • 最小实例数,如果指定的实例数大于金山云在本Region所能创建的最大实例数,则不会创建任何实例。
  • 类型: Integer
  • 有效值: 最小值1,最大值为MIN(当前用户实例剩余配额,30),即用户剩余配额和100比较的小者
  • 是否可缺省: 否

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字符,必须包含大小写英文字符和数字,支持其他可见字符
  • 是否可缺省: 否

ChargeType

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

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

  • 开启增强联网,只支持IO优化型8核、16核套餐,只支持- CentOS操作系统6.5、6.6、6.7、7.0、7.1,Ubuntu 14.04操作系统。
  • 默认值:false
  • 类型:Boolean
  • 是否可缺省:是

Response Elements(返回值)

RequestId

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

InstancesSet

Examples(例子)

在cn-beijing-6这个region,创建一个实例,实例套餐类型C1.1A,数据盘大小50GB,计费类型包年包月,购买时长一个月,实例名称test_2

Sample Request(请求)
http://kec.cn-beijing-6.api.ksyun.com/?Action=RunInstances&Version=2016-03-04
&MaxCount=1
&MinCount=1
&ImageId=314bbaa0-6ea3-4042-ae58-4d499a0a607b
&SubnetId=d91f7510-2b59-4600-bc26-9c34c1b38493
&InstancePassword=1qaz2wsx!Q
&SecurityGroupId=c032ce42-b457-4f36-a557-297994f172ac
&DataDiskGb=50
&ChargeType=Monthly
&InstanceType=C1.1A
&PurchaseTime=1
&InstanceName=test_2
&公共参数
Sample Response(返回)
<?xml version="1.0" encoding="UTF-8"?>
<RunInstancesResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <RequestId>d13fbf44-f6ac-4030-96a6-4f5b38e8ca86</RequestId>
    <InstancesSet>
        <Item>
            <InstanceName>test_2</InstanceName>
            <InstanceId>d7d3e0b3-eeb1-40a3-89f3-a6100f14522b</InstanceId>
        </Item>
    </InstancesSet>
</RunInstancesResponse>

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

注册有礼