创建云主机

本页目录

https://www.cloudam.cn/vps/cvmresource/new?accountId={ACCOUNT_ID}

请求方式：POST

创建云主机，包含弹性公网IP以及绑定所需的抢占式服务器资源

注1: 请确保你的账户有足够的余额用来支付创建资源所需的费用

注2: 请首先联系Cloudam获取API Token

URL Parameters

Parameter	Type	Description
ACCOUNT_ID	`String`	你的Cloudam账户ID， Cloudam会随Token一起提前发送给客户 Example: demoaccount

Body Attributes(Body属性)

Attribute	Type	Description
provider	`String`	IP所属云厂商，取值范围：aliyun、aws 、 awscn 、 tencent 、 random。aliyun：阿里云， aws：亚马逊云海外，awscn：亚马逊云中国，tencent：腾讯云，random：随机选择, 系统将按照你选择的地域自动匹配云厂商默认值: aliyun
region	`String`	阿里云支持地域范围： shenzhen 、 shanghai、 qingdao、beijing 、 hangzhou 、 mainland 、 hongkong 、singapore 、 australia 、 malaysia 、yajiada 、 virginia、 california、 uk、canada、france、 sweden、 s-korea、 india、 germany、 meast、 asiapa、 us、 europe 腾讯云支持地域范围： beijing 、 chengdu、chongqing、 guangzhou 、 hongkong 、 shanghai 、 mainland 、 singapore 、 japan 、 germany 、moscow 、 virginia、 california、 us、 oversea、 europe
instanceSpecKey	`String`	指定服务器规格值，如 1核1G内存： "1-1", 2核2G内存： "2-2", 2核4G内存: "2-4" 默认值: 空
logintype	`String`	IP所属服务器登陆方式，取值范围： keypair 、 password 默认值: password
loginPassword	`String`	登录密码默认值: 空
keypair	`Integer`	密钥对名称，需要提前联系客服导入公钥默认值: 空
autorenew	`Boolean`	是否开启到期自动续费，取值范围： true 、 false 默认值: false
period	`Integer`	购买时长(单位：unit属性)，取值范围： 1 - 36 默认值: 1
unit	`Integet`	购买时长单位，取值范围： week 、 month，当前仅支持month 默认值: month
amount	`Integer`	购买云主机数量(单位：个)，取值范围： 1 - 100 默认值: 1
autorenew	`Boolean`	是否开启到期自动续费，取值范围： true 、 false 默认值: false
startscript	`String`	IP绑定服务器启动脚本，Base64编码，需参考云厂商关于userdata脚本的要求撰写，最长不超过16KB 默认值: 空
bangWidth	`Integer`	带宽，当前仅支持 1,2,3,4,5,6,7,8,9,10,15,20,25,50 默认值: 1
systemDiskSize	`Integer`	系统盘大小，请选择不小于所选镜像大小的磁盘，当前仅支持 20, 40, 50, 80, 100, 150, 200 默认值: 20
dataDiskSize	`Integer`	数据盘大小，数据盘需要自己执行挂载，当前仅支持 20, 40, 50, 80, 100, 150, 200 默认值: 0
imageKey	`String`	指定服务器操作系统镜像，需提前联系Cloudam协商所需镜像规格并获取imageKey支持清单默认值: Centos7
ports	`String JsonArray`	云主机需要开放的端口号默认值: 无

Request(请求)

Headers(HTTP头) 注: 请首先联系Cloudam获取API Token，token相当于密码，请妥善保护。

{
    "Authorization": "Bearer ${token}",
    "Content-Type": "application/json"
}

Body(请求体JSON)

{
  "name": "电商客户某某",
  "region": "mainland",
  "period": 1,
  "amount": 3,
  "instanceSpecKey": "1-1"
}

Response(响应) - 200

Headers(响应头)

{
    "Content-Type": "application/json"
}

Body(响应体JSON) -- 正确响应

{
  "requestid": "sg-f8c43339a8ed4e4688fc4c64cfc549ca",
  "iplist": [
    {"ip": "202.10.3.17", "validTill": "2019-06-28T07:11:12Z"},
    {"ip": "202.10.3.18", "validTill": "2019-06-28T07:11:13Z"},
    {"ip": "202.10.3.19", "validTill": "2019-06-28T07:11:15Z"}
  ],
  "errorCode":"",
  "balance": 500
}

Response Body Attributes(响应Body属性)

Attribute	Type	Description
requestid	`String`	本次请求ID - requestid可以被用来查询请求结果。
iplist	`Array`	成功创建的IP资源数组 - 如果一个都没有创建成功则为空数组。
iplist.ip	`String`	弹性公网IP地址
iplist.validTill	`String`	该弹性公网IP地址有效期，按照 ISO8601 标准表示，并需要使用 UTC 时间。格式为：yyyy-MM-ddTHH:mm:ssZ 过期后如果没有续费则自动释放该IP
errorCode	`String`	如果指定数量的IP没有全部创建成功，则此属性不为空，可能取值如下： User.NotAllowed：用户Token无效或过期。 User.NotEnoughBalance：用户账户余额不足。 Cloud.NotEnoughResource：云厂商此刻IP资源不足，客户端在收到此错误码后可以稍等5分钟后再次尝试调用。
balance	`Integer`	用户账户余额(单位：元)。注：此为此次购买操作结束后的余额。

本页目录#

请求方式：POST#

URL Parameters#

Body Attributes(Body属性)#

Request(请求)#

Response(响应) - 200#

Response Body Attributes(响应Body属性)#