选择性释放EIP
更新时间：2025-08-04
选择性释放EIP
描述
- 选择将指定EIP直接释放或放入回收站内，默认直接释放。
- 预付费已到期、后付费-按流量、后付费-按带宽状态的 EIP 实例可以选择放入回收站或直接释放。
- 释放指定EIP，被释放的EIP无法找回。
- 回收站内EIP实例保留7天，超过7天则自动释放不可恢复；7天内可以手动选择恢复或删除指定EIP。
- EIP实例如果被绑定到任意实例，需要先解绑才能直接释放。
- EIP实例进入回收站后，强制解除绑定关系，恢复实例后需重新配置。
- 在回收站的EIP有配额限制，默认在每个地域回收站保留10个EIP，按时间倒序。当回收站内EIP数额达到10个时，新进入的EIP会挤走之前的EIP。
- 若EIP实例为后付费已欠费，无论何种选择系统都将直接释放EIP实例。
请求结构
Plain Text
1DELETE /v{version}/eip/{eip}?releaseToRecycle={releaseToRecycle}&clientToken={clientToken} HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1。 |
| eip | String | 是 | URL参数 | 被选择释放的EIP地址，包括IPv4 EIP和IPv6 EIP。 |
| releaseToRecycle | Boolean | 否 | Query参数 | 是否将指定EIP放入回收站，缺省值为false，代表将EIP直接释放。 |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见幂等性。 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
无特殊返回参数
IPv4 EIP请求示例
Plain Text
1DELETE /v1/eip/180.181.3.133?releaseToRecycle=true&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2HOST: eip.bj.baidubce.com
3Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2025-08-04T02:14:00Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02IPv6 EIP请求示例
Plain Text
1DELETE /v1/eip/240c:4082:ffff:ff01:0:4:0:12a?releaseToRecycle=true&clientToken=910ba8a8-fa0e-4cd5-a0b9-f0c7a89ccb82 HTTP/1.1
2HOST: eip.bj.baidubce.com
3Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2025-08-04T02:14:00Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Tue, 14 Feb 2022 02:14:03 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS