RunInstances

创建指定配置,指定数量的主机。

当你创建主机时,主机会先进入 pending 状态,直到创建完成后,变为 running 状态。 你可以使用 DescribeInstances 检查主机状态。

创建主机时,一旦参数 vxnets.n 包含基础网络(即: vxnet-0 ),则需要指定防火墙 security_group,如果没有指定,青云会自动使用缺省防火墙。

青云给主机定义了几种经典配置,可通过参数 instance_type 指定,配置列表请参考 Instance Types 。 如果经典配置不能满足你的需求,可通过参数 cpu, memory 自定义主机配置。

如果参数中既指定 instance_type ,又指定了 cpumemory , 则以指定的 cpumemory 为准。

Request Parameters

Parameter name Type Description Required
image_id String 映像ID,此映像将作为主机的模板。可传青云提供的映像ID,或自己创建的映像ID Yes
instance_type String

主机类型,有效值请参考 Instance Types

如果请求中指定了 instance_type,cpu 和 memory 参数可略过。
如果请求中没有 instance_type,则 cpu 和 memory 参数必须指定。
如果请求参数中既有 instance_type,又有 cpu 和 memory,则以 cpu, memory 的值为准。
No
cpu Integer CPU core,有效值为: 1, 2, 4, 8, 16 No
memory Integer 内存,有效值为: 1024, 2048, 4096, 6144, 8192, 12288, 16384, 24576, 32768 No
count Integer

创建主机的数量,默认是1

注解

当同时创建多台主机时,这些主机的基本信息和配置都是相同的

No
instance_name String 主机名称 No
login_mode String

指定登录方式。当为 linux 主机时,有效值为 keypairpasswd; 当为 windows 主机时,只能选用 passwd 登录方式。

当登录方式为 keypair 时,需要指定 login_keypair 参数;
当登录方式为 passwd 时,需要指定 login_passwd 参数。
Yes
login_keypair String 登录密钥ID。 No
login_passwd String 登录密码。 No
vxnets.n String

主机要加入的私有网络ID,如果不传此参数,则表示不加入到任何网络。

如果是自建的受管私有网络(不包括基础网络 vxnet-0 ),则可以在创建主机时指定内网IP, 这时参数值要改为 “vxnet-id|ip-address” ,如 “vxnet-abcd123|192.168.1.2” 。

No
security_group String 主机加载的防火墙ID,只有在 vxnets.n 包含基础网络(即:vxnet-0)时才需要提供。 若未提供,则默认加载缺省防火墙 No
volumes.n String 主机创建后自动加载的硬盘ID,如果传此参数,则参数 count 必须为1 。 No
hostname String 可指定主机的 hostname 。 No
need_newsid Integer 1: 生成新的SID,0: 不生成新的SID, 默认为0;只对Windows类型主机有效。 No
need_userdata Integer 1: 使用 User Data 功能;0: 不使用 User Data 功能;默认为 0 。 No
userdata_type String User Data 类型,有效值:’plain’, ‘exec’ 或 ‘tar’。为 ‘plain’或’exec’ 时,使用一个 Base64 编码后的字符串;为 ‘tar’ 时,使用一个压缩包(种类为 zip,tar,tgz,tbz)。 No
userdata_value String User Data 值。当类型为 ‘plain’ 时,为字符串的 Base64 编码值,长度限制 4K;当类型为 ‘tar’,为调用 UploadUserDataAttachment 返回的 attachment_id。 No
instance_class String 主机性能类型: 性能型:0 ,超高性能型:1 No
cpu_model String CPU指令集, 有效值: Westmere, SandyBridge No
cpu_topology String CPU 拓扑结构: 插槽数, 核心数, 线程数; 插槽数 * 核心数 * 线程数 应等于您应选择的CPU数量。 No
nic_mqueue Integer 网卡多对列: 关闭(默认):0,开启:1 No
userdata_path String User Data 和 MetaData 生成文件的存放路径。不输入或输入不合法时,为默认目录 /etc/qingcloud/userdata No
userdata_file String userdata_type 为 ‘exec’ 时,指定生成可执行文件的路径,默认为/etc/rc.local No
target_user String 目标用户 ID ,可用于主账号为其子账号创建资源。 No
zone String 区域 ID,注意要小写 Yes

Response Elements

Name Type Description
action String 响应动作
instances Array 创建的主机ID列表
job_id String 执行任务的 Job ID
ret_code Integer 执行成功与否,0 表示成功,其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=RunInstances
&vxnets.1=vxnet-0
&instance_type=small_a
&image_id=centos63x64
&COMMON_PARAMS

Example Response:

{
  "action":"RunInstancesResponse",
  "instances":[
    "i-rtyv0968"
  ],
  "job_id":"j-bm6ym3r8",
  "ret_code":0
}