云主机
API概览
调用方式
概述
 公共参数
 请求签名
 错误码
云主机相关
创建云主机 查询云主机 云主机开机 云主机关机 云主机重启 云主机删除 云主机修改密码 云主机重装操作系统 云主机修改名称 云主机VNC地址 云主机续费 云主机变更配置 云主机变更防火墙 云主机变更私有网络
云主机快照相关
创建云主机快照 删除云主机快照 修改云主机快照 查询云主机快照信息 云主机快照还原
SSH 密钥对相关
密钥对列表 删除密钥对 创建密钥对 创建已有密钥对 挂载密钥对 卸载密钥对 修改密钥对
镜像管理相关
查询镜像 创建自定义镜像 修改镜像 删除镜像
附录
实例规格组 地域 使用限制
API文档>云主机>云主机相关>创建云主机
  • 接口说明
  • 接口调试

创建云主机

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

描述

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

镜像

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

网络标识

  • 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.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
&<公共请求参数>

返回示例

旧版只返回data里面的数据

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