文档中心
文档中心 >
下载PDF文档

RunInstances（创建实例）

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

Request Parameters（请求参数）

ImageId

  • 镜像ID
  • 类型: #### Request Parameters（请求参数）
  • 有效值：标准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优化型：1.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.24C| I1.24B| I1.24D| I1.32A| I1.32B；
    • 通用型：N1.1A | N1.1B | N1.1C | N1.2A | N1.2B | N1.2C | N1.4A | N1.4B | N1.4C | N1.8A | N1.8B | N1.8C | N1.16A | N1.16B | N1.26C | N1.32A | N1.32B 具体套餐信息参考 实例套餐类型定义

  • 是否可缺省: 是

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（例子）

在默认region，创建一个实例，实例套餐类型C1.1A，数据盘大小50GB，计费类型包年包月，购买时长一个月，实例名称test_2

Sample Request(请求)
http://kec.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
&AUTHPARAMS
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>