API文档>云主机>云主机相关>创建云主机
  • 接口说明
  • 接口调试

创建云主机

更新时间：2020-10-20 17:46:23

描述

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

镜像

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

网络标识

  • 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； 如果不需要购买公网IP，则Internet.0.xxx的参数都不需要传值
Internet.0.BandwidthId String 否

共享宽带ID，可通过查询共享宽带列表方法获取； 如果云主机公网IP要加入共享带宽，则需要指定共享带宽
Internet.0.BandwidthPayType String 否

网络计费类型。默认采用按带宽计费，如果采用按流量计费则需要传值；

  • DISCHARGE：按流量付费
Internet.0.EipType String 否

网络类型：ChinaTelecom(中国电信), 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"
    }
}
*
*
*
*
*
*
*
*
*
*