解绑弹性公网IP

最近更新时间: 2024-10-18 10:38:45

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 公共参数,详见产品支持的地域列表(TODO)
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
InvalidParameter
InvalidAddressId.Blocked
InvalidAddressId.Blocked
InvalidAddressId.NotFound
InvalidAddressIdStatus.NotPermit
InvalidInstance.NotSupported