创建云主机

更新时间: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"
    }
}
*
*
*
*
*
*
*
*
*
*