IP资源续费
本页目录
https://www.cloudam.cn/intelligroup/renewip?accountId={ACCOUNT_ID}
请求方式:PUT
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 |
---|---|---|
iplist | Array | 待续费IP地址列表。 |
period | Integer | 续费时长(单位:月), 取值范围: 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属性)
Attribute | Type | Description |
---|---|---|
iplist | String | 成功续费的IP数组 - 如果一个都没有续费成功则返回空数组。 |
iplist.ip | Array | 成功续费IP地址 |
iplist.validTill | String | 该IP续费后有效期,按照 ISO8601 标准表示,并需要使用 UTC 时间。格式为:yyyy-MM-ddTHH:mm:ssZ |
errorCode | String | 如果指定数量的IP没有全部续费成功,则此属性不为空,可能取值如下: User.NotAllowed:用户Token无效或过期。 User.NotEnoughBalance:用户账户余额不足。 |
balance | Integer | 用户账户余额(单位:元)。注:此为此次续费操作结束后的余额 |