创建IP资源

本页目录

https://www.cloudam.cn/intelligroup/ipresources?accountId={ACCOUNT_ID}

请求方式：POST

创建预付费IP组，包含弹性公网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
name	`String`	IP资源组名称 - 最好使用具体客户名，方便后期问题查询及追踪。不超过30个字符，仅限中英文，数字和"-"，"_"
provider	`String`	IP所属云厂商，取值范围：aliyun、aws 、 awscn 、 tencent 、 random。aliyun：阿里云， aws：亚马逊云海外，awscn：亚马逊云中国，tencent：腾讯云，random：随机选择, 系统将按照你选择的地域自动匹配云厂商默认值: aliyun
region	`String`	IP所在地域，取值范围：beijing 、 shenzhen、 guangzhou 、 shanghai 、 hangzhou 、 qingdao 、 chengdu 、 ningxia 、mainland 、 asiapa 、 hongkong 、 japan 、 us 、 malaysia 、 singapore 、 australia、 germany、 uk、 canada、 france、 sweden 、 s-korea、 india、 brazil、 virginia、 ohio、 california、 oregon ireland、 london。beijing：北京(aliyun、 awscn 、 tencent)， shenzhen：深圳(aliyun)，guangzhou：广州(tencent)，shanghai：上海(aliyun 、 tencent)，hangzhou：杭州(aliyun)，qingdao：青岛(aliyun)，chengdu：成都(tencent)，ningxia：宁夏(awscn)， mainland：中国内地随机(aliyun 、 awscn 、 tencent)， asiapa：亚太地区(aliyun 、 aws 、 tencent)，hongkong：香港(aliyun 、 aws 、 tencent)，japan：日本(aliyun 、 aws)，us：美国(aliyun 、 aws、 tencent)， malaysia：马来西亚(aliyun)，singapore：新加坡(aliyun 、aws)，australia：澳大利亚(aliyun 、 aws)，germany：德国(aliyun 、 aws) ，uk：英国(aws)，canada：加拿大(aws)，france：法国(aws)，sweden：瑞典(aws)， s-korea：韩国(aws)，india：印度(aws)，brazil：巴西(aws) ，virginia：美东弗吉尼亚(aws 、 tencent)，ohio：美东(俄亥俄)(aws)，california：美西加州(aws、 tencent)，oregon：美西俄勒冈州(aws) ，ireland：爱尔兰(aws)，london：伦敦(aws)
logintype	`String`	IP所属服务器登陆方式，取值范围： keypair 、 password 默认值: password
period	`Integer`	购买时长(单位：unit属性)，取值范围： 1 - 36 默认值: 1
unit	`String`	购买时长单位，取值范围： week 、 month，当前仅支持month
amount	`Integer`	购买IP数量(单位：个)，取值范围： 1 - 100 默认值: 1
autorenew	`Boolean`	是否开启到期自动续费，取值范围： true
ipkeptperiod	`Integer`	到期保留IP时长（单位：天），IP过期后系统会删除服务器，但是可保留IP一定时间，保留IP要收取IP保留费用，取值范围： 0 - 7 默认值: 0
startscript	`String`	IP绑定服务器启动脚本，Base64编码，需参考云厂商关于userdata脚本的要求撰写，最长不超过16KB 默认值: 空
instanceSpecKey	`String`	指定服务器规格key值，需提前联系Cloudam协商所需服务器规格并获取instanceSpecKey支持清单默认值: 空
imageKey	`String`	指定服务器操作系统镜像，需提前联系Cloudam协商所需镜像规格并获取imageKey支持清单默认值: 空

Request(请求)

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

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

Body(请求体JSON)

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

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属性)#