DisassociateAddress
最近更新时间: 2025-10-20 17:06:03
1. 接口描述
接口请求域名： vpc.api3.fincloud.tencent.cn。
本接口 (DisassociateAddress) 用于解绑弹性公网IP（简称 EIP）。
- 支持CVM实例，弹性网卡上的EIP解绑
- 不支持NAT上的EIP解绑。NAT上的EIP解绑请参考DisassociateNatGatewayAddress
- 只有状态为 BIND 和 BIND_ENI 的 EIP 才能进行解绑定操作。
- EIP 如果被封堵，则不能进行解绑定操作。
默认接口请求频率限制：10次/秒。
接口更新时间：2022-06-22 17:44:02。
接口只验签名不鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：DisassociateAddress |
| Version | 是 | 否 | String | 公共参数，本接口取值：2017-03-12 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| AddressId | 是 | 否 | String | 标识 EIP 的唯一 ID。EIP 唯一 ID 形如：eip-11112222。 |
| KeepAddressIdBindWithEniPip | 否 | 否 | Bool | 此参数对外不可见。 表示解绑时是EIP从ENI上解绑，还是ENI+EIP从实例上解绑 |
| ReallocateNormalPublicIp | 否 | 否 | Bool | 表示解绑 EIP 之后是否分配普通公网 IP。取值范围：<br><li>TRUE：表示解绑 EIP 之后分配普通公网 IP。<br><li>FALSE：表示解绑 EIP 之后不分配普通公网 IP。<br>默认取值：FALSE。<br><br>只有满足以下条件时才能指定该参数：<br><li> 只有在解绑主网卡的主内网 IP 上的 EIP 时才能指定该参数。<br><li>解绑 EIP 后重新分配普通公网 IP 操作一个账号每天最多操作 10 次；详情可通过 DescribeAddressQuota 接口获取。 |
| CascadeRelease | 否 | 否 | Bool | 此参数对外不可见。 [Deprecated] 表示解绑后是否自动释放EIP |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| TaskId | String | 此参数对外不可见。 异步任务TaskId。可以使用DescribeTaskResult接口查询任务状态。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InvalidInstanceId.NotFound | 无效实例ID。指定的实例ID不存在。 |
| InvalidParameter | 入参不合法。 |
| InvalidAddressId.Blocked | 指定EIP处于被封堵状态。当EIP处于封堵状态的时候是不能够进行绑定操作的，需要先进行解封。 |
| InvalidAddressId.Blocked | 指定EIP处于被封堵状态。当EIP处于封堵状态的时候是不能够进行绑定操作的，需要先进行解封。 |
| InvalidAddressId.NotFound | 指定的EIP不存在。 |
| InvalidAddressIdStatus.NotPermit | 指定 EIP 当前状态不能进行绑定操作。只有 EIP 的状态是 UNBIND 时才能进行绑定操作。 |
| InvalidInstance.NotSupported | 不被支持的实例。 |