全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

创建专属云主机

最近更新时间:2024-03-15 14:47:18

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

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈