变更弹性公网IP带宽
1. 接口描述
调用 DownGradeEipSpec 或 UpGradeEipSpec 接口变更弹性公网IP带宽。
- 升级预付费弹性公网IP的带宽，系统会预先扣除本次实例升级所需金额，请确保账户余额充足。
- 弹性公网IP状态必须为 AVAILABLE 时才能变更带宽。
- 已被限制的弹性公网IP不允许变更带宽
2. 请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：DownGradeEipSpec 或 UpGradeEipSpec 注意：升级带宽固定取值UpGradeEipSpec ；降级带宽固定取值DownGradeEipSpec |
| EipUUID | String | 是 | 弹性公网IP标识 |
| Bandwidth | Integer | 是 | 带宽大小, 单位Mbps |
| InstanceChargeType | String | 是 | 付费方式，取值范围: PRE_PAID 预付费 POST_PAID 后付费 |
| ClientToken | String | 是 | 用于保证幂等性 |
3. 返回数据
| 名称 | 类型 | 说明 |
|---|---|---|
| RequestId | String | 请求ID |
4. 示例
请求示例
https://openapi.kaopuyun.com/?SignatureVersion=1.0
&Action=UpGradeEipSpec
&Format=JSON
&EipUUID=eip-3m0000gftg8m
&SignatureNonce=fad368fd-b5e3-476b-903b-2ef34e0e9fba
&Version=2014-05-26
&AccessKeyId=hfWkfqG6a794
&Signature=IcyHYfUBWSzJauAbDaqniNSNE94=
&SignatureMethod=HMAC-SHA1
&Timestamp=2023-02-25T15:29:21Z
&Bandwidth=10
&InstanceChargeType=PRE_PAID
&ClientToken=125558666
正常返回示例
{
"RequestId":"742fbe80-0ea9-11eb-9b36-0208cb7f7896"
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| MissingParameter | Bandwidth 参数不能为空 |
| MissingParameter | InstanceChargeType 参数不能为空 |
| ValueNotSupported | InstanceChargeType 参数不合法 |
| EipExpiredUnChange | 弹性公网IP已经过期，无法变更 |
| EipTryoutUnChange | 弹性公网IP在试用中，无法变更 |
| DownGradeEipSpecFail | 弹性公网IP降配失败:xxx |