创建云主机

更新时间:2019-08-28 14:28:04

描述

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

镜像

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

网络标识

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

防火墙

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

请求参数

参数名参数类型是否必填参数说明
ActionString

操作方法:RunInstance

RegionString

机房标识,取值参见地域列表

PayTypeString

付费类型。取值范围:

  • PREPAID:包年包月
  • PROBATION :试用
PeriodInteger

购买时长

  • 包年包月,取值范围: 1,2,3,4,5,6,7,8,9,12,24,36,单位:月;
  • 试用,取值3,单位:天
InstanceSeriesString

主机系列,取值范围:

  • SERIES_STANDARD:普通型
  • SERIES_SUPERCOMPUTER:计算增强型
ImageIdString

镜像标识,可通过查找镜像方法获取

InstanceTypeString

实例的资源规格。取值参见实例规格组

Volumes.0.TypeString

系统盘的云硬盘类型,取值范围:

  • sata-vm:普通盘
  • ssd-vm:高性能盘
Volumes.0.SizeInteger

系统盘大小,单位GB

Volumes.1.TypeString

挂载的第一块云硬盘类型,见系统盘

Volumes.1.SizeInteger

挂载的第一块云硬盘大小,单位GB

Volumes.2.TypeString

挂载的第二块云硬盘类型,见系统盘

Volumes.2.SizeInteger

挂载的第二块云硬盘大小,单位GB

Volumes.3.TypeString

挂载的第三块云硬盘类型,见系统盘

Volumes.3.SizeInteger

挂载的第三块云硬盘大小,单位GB

Volumes.4.TypeString

挂载的第四块云硬盘类型,见系统盘

Volumes.4.SizeInteger

挂载的第四块云硬盘大小,单位GB

Interface.0.NetworkIdString

私有网络ID,可通过查询私有网络信息方法获取; 如果要加入默认网络,则使用DEFAULT

Internet.RouterIdString

路由器 ID,可通过查询路由器信息方法获取;

  • 如果加入默认网络,则不需要指定路由器ID
  • 如果加入的私有网络不是默认网络,则此处需要指定路由器ID
Internet.0.BandwidthInteger

公网IP宽带大小,单位Mbps; 如果不需要购买公网IP,则Internet.0.xxx的参数都不需要传值

Internet.0.BandwidthIdString

共享宽带ID,可通过查询共享宽带列表方法获取; 如果云主机公网IP要加入共享带宽,则需要指定共享带宽

Internet.0.BandwidthPayTypeString

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

  • DISCHARGE:按流量付费
Internet.0.EipTypeString

网络类型:ChinaTelecom(中国电信), BGP,ChinaUnicom(中国联通),ChinaMobile(中国移动),Oversea(海外),请参见地域列表获取不同地域支持的网络类型; 不指定则采用地域默认的网络类型

Internet.0.SlaveEipCountInteger

购买附属IP数量,最大支持5个附属IP; 购买附属IP必须设置Internet.0.Bandwidth

KeyPairString

密钥ID,可通过密钥对列表方法获取; 指定密钥ID的话,则Password参数无效

FirewallIdString

防火墙ID,可通过查找防火墙方法获取。不指定则使用默认防火墙

NameString

实例名称

PasswordString

云主机密码,由大小写字母、数字和特殊字符组成

返回参数

名称 类型 说明
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.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
&<公共请求参数>

返回示例

旧版只返回data里面的数据

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