解绑弹性公网IP

最近更新时间:2019-12-03 11:25:35

我的收藏
说明:
当前页面接口为旧版 API,未来可能停止维护,目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 云服务器 API 3.0

1. 接口描述

域名: eip.api.qcloud.com 接口名: EipUnBindInstance
弹性公网 IP 与服务器解绑。
注意:
平台对用户每地域每日解绑 EIP 重新分配普通公网 IP 次数有所限制(可参见EIP 产品简介)。上述配额可通过 DescribeEipQuota 接口获取。

2. 输入参数

参数名称
必选
类型
描述
eipId
String
EIP 实例 ID,可通过DescribeEip接口返回字段中的 eipId 获取
allocWanIp
Int
弹性公网 IP 与服务器解绑后,是否需要为服务器的主网卡主 IP 重新分配新的普通公网 IP。该普通公网 IP 随着服务器的释放而释放,不具备弹性。
0:不分配; 1:分配(默认为0)。
networkInterfaceId
String
弹性网卡唯一 ID,可通过DescribeNetworkInterfaces接口返回字段中的 networkInterfaceId 获取
privateIpAddress
String
服务器内网 IP,解绑时或者传入参数 eipId,或者传入参数 networkInterfaceId 和privateIpAddress
unBindPrivateIpWithEip
Int
弹性公网 IP 与服务器解绑后,是否需要解除 networkInterfaceId 和 privateIpAddress 与 EIP 的关系。此参数仅对支持弹性网卡的服务器在非主网卡主 IP 解绑时有意义,其他默认解除。
0:不解除; 1:解除(默认为1)。

3. 输出参数

参数名称
类型
描述
code
Int
公共错误码。0表示成功,其他值表示失败。
message
String
模块错误信息描述,与接口相关。

4. 示例

输入
https://eip.api.qcloud.com/v2/index.php?
&eipId=eip-mksy14ay
&allocWanIp=0
输出
{
"code": 0,
"message": ""
}