帮助与文档

搜索
  • 云服务器
  • 弹性IP
  • VPC
  • CDN
  • IAM

文档中心

云服务器(KEC)

金山云 > 文档中心 > 云服务器(KEC) > API文档 > 实例

创建实例

最近更新时间：2020-06-22 10:33:44

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；
    • 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
    • 基础型E1：E1.1A | E1.1B| E1.1C| E1.1D| E1.2A| E1.2B| E1.2C|E1.2D| E1.4A| E1.4B| E1.4C| E1.4D| E1.8A| E1.8B| E1.8C| E1.8D| E1.16A| E1.16B| E1.16C| E1.16D|；
    • 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

  • 云主机系统盘配置参数。若不指定该参数，则按照系统默认值进行分配。
  • 类型：SystemDisk
  • 是否可缺省：是

DataDiskGb

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

DataDisk.n.Type

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

DataDisk.n.Size

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

DataDisk.n.SnapshotId

  • 第 n 个数据盘（云盘）的快照ID，n 的取值范围为 [1, 8]。支持SSD3.0云硬盘和EHDD高效云盘。DataDisk.n.Type与DataDisk.n.Size必须都填写才有效。
  • 类型：String
  • 是否可缺省：是

MaxCount

  • 最大实例数，当前用户允许创建的最大实例数。如果指定的实例数大于金山云在本人Region所能创建的最大实例数，则会创建大于MinCount数量的最大允许实例数。例如用户已创建了10个实例，还剩40个实例配额，最大实例数取为30个。如果用户指定创建35个实例，则最后只会创建30个实例。
  • 类型: Integer
  • 有效值: 最小值1，最大值为MIN(当前用户实例剩余配额，50），即用户剩余配额和50比较的小者
  • 是否可缺省: 否

MinCount

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

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}$
  • 是否可缺省: 否

LocalVolumeSnapshotId

  • 本地数据盘快照ID，可基于快照创建数据盘；必须指定DataDiskGb且大小和快照大小相同，此参数才有效
  • 类型: String
  • 是否可缺省: 是

InstancePassword

  • 实例开机密码（当InstancePassword、KeepImageLogin、KeyId.N都不传时，登录方式为创建后设置）
  • 类型: String
  • 有效值：最短8字符，最长32字符，必须包含大小写英文字符和数字，支持其他可见字符
  • 是否可缺省: 是

KeepImageLogin

  • 保留镜像设置登录。该参数只对使用自定义镜像有效。当该值填写为true，默认InstancePassword参数无效。（当InstancePassword、KeepImageLogin、KeyId.N都不传时，登录方式为创建后设置）
  • 类型：Boolean
  • 有效值：true | false
  • 默认值：false
  • 是否可以缺省：是

KeyId.N

  • 密钥ID（当InstancePassword、KeepImageLogin、KeyId.N都不传时，登录方式为创建后设置）
  • 类型：String
  • 是否可缺省：是

ChargeType

  • 计费类型，调用时需要明确指定，无默认值
  • 类型: String
  • 有效值：Monthly(包年包月）、Daily（按量付费（按日月结）)、 HourlyInstantSettlement（按量付费）、Spot（竞价型实例）
  • 是否可缺省: 否

PurchaseTime

  • 购买时长，单位月
  • 类型: Integer
  • 有效值：当计费类型为Monthly（包年包月）时，有效值1-36；其他计费类型时，不需要传此参数
  • 是否可缺省: 是

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. 使用的是金山云提高的标准镜像或者通过金山云标准镜像开机的实例再制作的自定义镜像
  • 类型：String
  • 是否可缺省：是

ProjectId

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

DataDisk.n.DeleteWithInstance

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

DataGuardId

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

SpotStrategy

  • 竞价实例的抢占策略，当参数ChargeType为Spot（竞价型实例）时生效
  • 类型: String
  • 有效值： SpotWithPriceLimit：设置上限价格的抢占式实例。合法值“当前市场价~按小时实时结算价格”区间，输入值不在此区间非法。 SpotAsPriceGo（默认）：系统自动出价，跟随当前市场实际价格
  • 是否可缺省: 是

SpotPriceLimit

  • 设置实例的每小时最高价格。参数SpotStrategy取值为SpotWithPriceLimit时生效
  • 类型：Float
  • 有效值：支持最大5位小数
  • 是否可缺省：是

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
  • 是否可缺省: 是
  • 缺省值: 默认项目

ModelId

  • 实例启动模板ID，使用启动模板创建实例；如果批量创建，实例名称后缀依然存在
  • 类型: String
  • 是否可缺省: 是
  • 缺省值: 默认项目

AutoDeleteTime

  • 自动删除时间
  • 是否可缺省：是
  • 格式：2019-07-16 18:56

AutoDeleteEip

  • 随主机定时删除绑定的弹性IP
  • 类型：Boolean
  • 是否可缺省：是
  • 默认值：false
  • 注：包年包月的弹性IP只解绑，不删除；只有AutoDeleteTime有效值生效时，该参数才生效

HostName

  • 操作系统内部的计算机名
  • 类型：String
  • 有效值：字符长度为[2, 64]，不支持点号（.），每段允许字母（不限制大小写）、数字和短横线（-）组成
  • 是否可缺省: 是

HostNameSuffix

  • 创建多台实例时为HostName增加有序后缀，有序后缀从1增加，例如host-1，
  • 类型：int
  • 有效值：0-9999
  • 是否可缺省: 是，默认值为空；

UserData

  • 提供给实例启动时使用的用户自定义数据，需要以 base64 方式编码，支持的最大数据大小为 16KB
  • 类型：String
  • 有效值：需要以 base64 方式编码
  • 是否可缺省: 是

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（返回）
{
  "RequestId": "483f0bd0-eddc-4311-9644-51167cf0dad9",
  "InstancesSet": [
    {
      "InstanceId": "28474a3e-446b-463b-815b-f7b9bd468f7e",
      "InstanceName": "test_2"
    }
  ]
}

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

免费注册