创建专属云主机

RunInstances（创建专属云主机）

接口描述

本接口（RunInstances）用于创建专属云主机

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

• 是否可缺省: 否

DedicatedHostId

• 专属宿主机ID

• 类型：String

• 是否可缺省：否

InstanceConfigure.VCPU

• 实例VCPU核数

• 类型：int

• 是否可缺省：否

InstanceConfigure.MemoryGb

• 实例内存

• 类型：int

• 是否可缺省：否

InstanceType

• 实例套餐类型

• 类型: String

• 有效值: DVM1.NONE，DVM2.NONE

• 是否可缺省: 是

DataDiskGb

• 数据卷容量，单位GB

• 类型: Integer

• 是否可缺省: 是

MaxCount

• 最大实例数，如果指定的实例数大于金山云在本人Region所能创建的最大实例数，则会创建大于MinCount数量的最大允许实例数。

• 类型: Integer

• 有效值: 最小值1，最大值为当前用户实例剩余配额

• 是否可缺省: 否

MinCount

• 最小实例数，如果指定的实例数大于金山云在本Region所能创建的最大实例数，则不会创建任何实例。

• 类型: Integer

• 有效值: 最小值1，最大值为当前用户实例剩余配额

• 是否可缺省: 否

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（按量付费（按日月结）)、 PostPaidByHour（按量付费（按小时月结））

• 是否可缺省: 否

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

• 是否可缺省: 是

ProjectId

• 实例所属项目ID

• 类型：long

• 有效值：账户有权限的项目ID，0为默认项目

• 是否可缺省：是

• 默认值：默认项目

DataDisk.n.DeleteWithInstance

• 数据盘是否随实例释放

• 类型：Boolean

• 有效值：

  • true：实例释放时，这块磁盘随实例一起释放。

  • false：实例释放时，这块磁盘保留不释放。

• 是否可缺省：是

• 默认值：false

Response Elements（返回值）

RequestId

• 请求ID

• 类型: String

• 是否可缺省: 否

InstancesSet

• 实例集合

• 类型: Object

• 是否可缺省: 否

Example（例子）

Sample Request（请求）

http://kec.cn-beijing-6.api.ksyun.com/?Action=RunInstances&Version=2016-03-04
&MaxCount=1&MinCount=1&ImageId=4b0fc64e-eb84-44ff-abc5-90dc5f889c2f
&SubnetId=2f9a37dc-ce70-403d-9978-852449f16249
&InstancePassword=Sq092095&SecurityGroupId=e9509616-b56c-4203-bb25-2a93ecd7dd1f&DataDiskGb=150
&ChargeType=Daily&InstanceType=DVM1.NONE&PurchaseTime=1&InstanceName=xytest2
&DedicatedHostId=27e368d0-55d8-4ab0-b560-a93ee90539fd&InstanceConfigure.VCPU=2
&InstanceConfigure.MemoryGb=4

Sample Response（返回）

{
    "RequestId": "a831f245-2694-47de-a417-a5e7d8b250f1012",
    "InstancesSet": [
        {
            "InstanceId": "2d6234da-d9b7-4d54-bd1a-63fe343a5879",
            "InstanceName": "xytest2"
        }
    ]
}