创建云主机
更新时间:2020-10-20 17:46:23
描述
根据请求参数创建云主机实例。注意以下几类请求参数的使用说明。
镜像
在创建实例时,必须要选择镜像,用来确定新创建实例的系统盘配置。 镜像包含操作系统以及应用软件配置。基于镜像创建实例后,实例的系统盘即为此镜像的完全克隆。 允许创建的镜像可查看可用镜像说明
网络标识
- Internet.0.NetworkId 可使用默认值:DEFAULT ,亦可使用自定义网络,参考:创建私有网络
- 如果使用自定义网络,并且开通的云主机带IP,需指定路由器字段Internet.RouterId,参考:创建路由器
防火墙
在创建实例时,系统会默认绑定缺省防火墙,也可指定自定义防火墙,参考:创建防火墙
请求参数
参数名 | 参数类型 | 是否必填 | 参数说明 |
---|---|---|---|
Region | String | 是 | 机房标识,取值参见地域列表 |
Action | String | 是 | 操作方法:RunInstance |
PayType | String | 是 | 付费类型。取值范围:
|
Period | Integer | 是 | 购买时长
|
InstanceSeries | String | 是 | 主机系列,取值范围:
|
ImageId | String | 是 | 镜像标识,可通过查找镜像方法获取 |
InstanceType | String | 是 | 实例的资源规格。取值参见实例规格组 |
Volumes.0.Type | String | 是 | 系统盘的云硬盘类型,取值范围:
|
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,可通过查询路由器信息方法获取;
|
Internet.0.Bandwidth | Integer | 否 | 公网IP宽带大小,单位Mbps; 如果不需要购买公网IP,则Internet.0.xxx的参数都不需要传值 |
Internet.0.BandwidthId | String | 否 | 共享宽带ID,可通过查询共享宽带列表方法获取; 如果云主机公网IP要加入共享带宽,则需要指定共享带宽 |
Internet.0.BandwidthPayType | String | 否 | 网络计费类型。默认采用按带宽计费,如果采用按流量计费则需要传值;
|
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"
}
}