预付费EIP退订
- 预付费EIP释放并退款。
- 只有预付费EIP支持退订，后付费EIP不支持退订，后付费EIP可调用释放EIP接口直接释放。
- 正在封禁中的EIP不支持退订，可在解封后再操作。
- 绑定了VPN、NAT的EIP不支持退订，可在解除绑定后再操作。
- 绑有带宽包的EIP不支持退订，可将带宽包释放后再操作。
- 共享带宽中的EIP不支持退订，可直接退订共享带宽或者将EIP移出共享带宽后释放。
EIP退款有惩罚机制，退款金额 = max(0, 总金额 - 已消费金额 * 1.5)
请求结构
PUT /v{version}/eip/refund/{eip}?clientToken={clientToken} HTTP/1.1
Host: eip.bj.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1 |
| eip | String | 是 | URL参数 | 待退订的EIP，包括IPv4 EIP和IPv6 EIP。 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见幂等性。 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
无特殊返回参数
IPv4 EIP请求示例
PUT /v1/eip/refund/120.48.186.29?clientToken=f4b26d37-445e-40bc-af98-07974495eae9 HTTP/1.1
HOST eip.bj.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2024-06-18T09:21:55Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02IPv6 EIP请求示例
PUT /v1/eip/refund/2400:da00:e003:2005:0:6:0:33c?clientToken=9b0afdb0-7aaa-4f27-bf59-7189ccd8457d HTTP/1.1
HOST eip.bj.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2024-06-18T09:21:55Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02响应示例
HTTP/1.1 200 OK
x-bce-request-id: 84b7e850-e547-4330-a063-f172296002e4
Date: Tue, 18 Jun 2024 09:21:55 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS