IP资源续费

本页目录

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

请求方式:PUT

IP资源续费,继续已经存在的IP资源

注1: 请请确保你的账户有足够的余额用来支付续费操作

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

URL Parameters

ParameterTypeDescription
ACCOUNT_IDString你的Cloudam账户ID, Cloudam会随Token一起提前发送给客户
Example: demoaccount

Body Attributes(Body属性)

AttributeTypeDescription
iplistArray待续费IP地址列表。
periodInteger续费时长(单位:月), 取值范围: 1 - 36
默认值: 1

Request(请求)

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

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

Body(请求体JSON)

{
"iplist": [
"201.23.34.56",
"201.23.58.59",
"214.13.58.110"
],
"period": 2
}

Response(响应) - 200

Headers(响应头)

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

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

{
"iplist": [
{"ip": "201.23.34.56", "validTill": "2019-06-28T07:11:12Z"},
{"ip": "201.23.58.59", "validTill": "2019-06-28T07:11:13Z"},
{"ip": "214.13.58.110", "validTill": "2019-06-28T07:11:15Z"}
],
"errorCode":"",
"balance": 500
}

Response Body Attributes(响应Body属性)

AttributeTypeDescription
iplistString成功续费的IP数组 - 如果一个都没有续费成功则返回空数组。
iplist.ipArray成功续费IP地址
iplist.validTillString该IP续费后有效期,按照 ISO8601 标准表示,并需要使用 UTC 时间。格式为:yyyy-MM-ddTHH:mm:ssZ
errorCodeString如果指定数量的IP没有全部续费成功,则此属性不为空,可能取值如下:
User.NotAllowed:用户Token无效或过期。
User.NotEnoughBalance:用户账户余额不足。
balanceInteger用户账户余额(单位:元)。注:此为此次续费操作结束后的余额