创建云主机

描述

根据请求参数创建云主机实例。注意以下几类请求参数的使用说明。

镜像

在创建实例时，必须要选择镜像，用来确定新创建实例的系统盘配置。 镜像包含操作系统以及应用软件配置。基于镜像创建实例后，实例的系统盘即为此镜像的完全克隆。 允许创建的镜像可查看可用镜像说明

网络标识

• Internet.0.NetworkId 可使用默认值：DEFAULT ，亦可使用自定义网络，参考：创建私有网络
• 如果使用自定义网络，并且开通的云主机带IP，需指定路由器字段Internet.RouterId，参考：创建路由器

防火墙

在创建实例时，系统会默认绑定缺省防火墙，也可指定自定义防火墙，参考：创建防火墙

请求参数

参数名	参数类型	是否必填	参数说明
Region	String	是	机房标识，取值参见地域列表
Action	String	是	操作方法：RunInstance
PayType	String	是	付费类型。取值范围： PREPAID：包年包月 PROBATION ：试用
Period	Integer	是	购买时长 包年包月，取值范围: 1,2,3,4,5,6,7,8,9,12,24,36，单位:月; 试用，取值3，单位:天
InstanceSeries	String	是	主机系列，取值范围： SERIES_STANDARD：普通型 SERIES_SUPERCOMPUTER：计算增强型
ImageId	String	是	镜像标识，可通过查找镜像方法获取
InstanceType	String	是	实例的资源规格。取值参见产品规格
Volumes.0.Type	String	是	系统盘的云硬盘类型，取值范围： sata-vm：普通盘 ssd-vm：高性能盘
Volumes.0.Size	Integer	是	系统盘大小，单位GB
Volumes.1.Type	String	否	挂载的第一块云硬盘类型，见系统盘
Volumes.1.Size	Integer	否	挂载的第一块云硬盘大小，单位GB
Volumes.2.Type	String	否	挂载的第二块云硬盘类型，见系统盘
Volumes.2.Size	Integer	否	挂载的第二块云硬盘大小，单位GB
Volumes.3.Type	String	否	挂载的第三块云硬盘类型，见系统盘
Volumes.3.Size	Integer	否	挂载的第三块云硬盘大小，单位GB
Volumes.4.Type	String	否	挂载的第四块云硬盘类型，见系统盘
Volumes.4.Size	Integer	否	挂载的第四块云硬盘大小，单位GB
Interface.0.NetworkId	String	是	私有网络ID，可通过查询私有网络信息方法获取； 如果要加入默认网络，则使用DEFAULT
Internet.RouterId	String	否	路由器 ID，可通过查询路由器信息方法获取； 如果加入默认网络，则不需要指定路由器ID 如果加入的私有网络不是默认网络，则此处需要指定路由器ID
Internet.0.Bandwidth	Integer	否	公网IP宽带大小，单位Mbps；上海一区支持5~100Mbps，其他数据中心支持2~100Mbps；如果不需要购买公网IP，则Internet.0.xxx的参数都不需要传值
Internet.0.BandwidthId	String	否	共享宽带ID，可通过查询共享宽带列表方法获取； 如果云主机公网IP要加入共享带宽，则需要指定共享带宽
Internet.0.BandwidthPayType	String	否	网络计费类型。默认采用按带宽计费，如果采用按流量计费则需要传值； DISCHARGE：按流量付费
Internet.0.EipType	String	否	网络类型：ChinaTelecom（中国电信）、BGP（多线BGP）、ChinaUnicom（中国联通）、ChinaMobile（中国移动）、Oversea（海外）、HKBGP（香港BGP），请参见地域列表获取不同地域支持的网络类型；不指定则采用地域默认的网络类型
Internet.0.SlaveEipCount	Integer	否	购买附属IP数量，最大支持5个附属IP； 购买附属IP必须设置Internet.0.Bandwidth
KeyPair	String	否	密钥ID，可通过密钥对列表方法获取； 指定密钥ID的话，则Password参数无效
FirewallId	String	否	防火墙ID，可通过查找防火墙方法获取。不指定则使用默认防火墙
Name	String	否	实例名称
Password	String	否	云主机密码，由大小写字母、数字和特殊字符组成

返回参数

名称	类型	说明
Action	String	执行的操作
TaskId	String	请求标识
InstanceId	String	单个开通，实例标识

请求示例

https://api.chinac.com/v2/?Action=RunInstance
&Region=cn-suzhou1
&Name=cec1705099S38
&ImageId=t-1q6th2o09b74s
&InstanceType=4核4G
&FirewallId=f-vg6th2tin4792
&Interface.0.NetworkId=DEFAULT
&Internet.0.Bandwidth=20
&Volumes.0.Size=20
&Volumes.0.Type=sata-vm
&Volumes.1.Size=100
&Volumes.1.Type=sata-vm
&PayType=PREPAID
&Period=1
&InstanceSeries=SERIES_STANDARD
&<公共请求参数>

返回示例

{
    "code": 10000,
    "message": "",
    "data": 
    {
        "TaskId": "bb112c20170506133720502",
        "Action": "RunInstance",
        "InstanceId" : "i-xxx"
    }
}