解绑定弹性公网IP

最近更新时间：2019-10-12 15:41:13

前往 GitHub 编辑 我的收藏

本页目录：

说明：

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

1. 接口描述

本接口 (DisassociateAddress) 用于解绑弹性公网IP（简称 EIP）。

接口请求域名：eip.api.qcloud.com

只有状态为 BIND 和 BIND_ENI 的 EIP 才能进行解绑定操作。
EIP 如果被封堵，则不能进行解绑定操作。

2. 输入参数

以下请求参数列表仅列出了接口请求参数，其它参数见公共请求参数页面。

参数名称	类型	是否必选	描述
Version	String	是	表示 API 版本号，主要用于标识请求的不同 API 版本。本接口第一版本可传：2017-03-12。
AddressId	String	是	标识 EIP 的唯一 ID。EIP 唯一 ID 形如：`eip-11112222`。
ReallocateNormalPublicIp	String	否	表示解绑 EIP 之后是否分配普通公网 IP。取值范围： TRUE：表示解绑 EIP 之后分配普通公网 IP。 FALSE：表示解绑 EIP 之后不分配普通公网 IP。默认取值：FALSE。只有满足以下条件时才能指定该参数：只有在解绑主网卡的主内网 IP 上的 EIP 时才能指定该参数。解绑 EIP 后重新分配普通公网 IP 操作一个账号每天最多操作 10 次；详情可通过 DescribeAddressQuota 接口获取。

3. 输出参数

参数名称	类型	描述
RequestId	String	唯一请求 ID。每次请求都会返回`RequestId`。当用户调用接口失败找后台研发人员处理时需提供该`RequestId`。

4. 错误码

以下错误码表仅列出了该接口的业务逻辑错误码，更多错误码详见公共错误码。

错误码	描述
InvalidAddressId.NotFound	指定的 EIP 不存在。
InvalidAddressId.Blocked	指定 EIP 处于被封堵状态。当 EIP 处于封堵状态的时候是不能够进行解绑定操作的，需要先进行解封。
InvalidAddressIdStatus.NotPermit	指定 EIP 当前状态不能进行解绑定操作。只有 EIP 的状态处于 BIND 或 BIND_ENI 状态时才能进行解绑定操作。
InvalidInstanceId.NotFound	指定实例 ID 不存在。
InvalidInstance.NotSupported	指定实例当前状态不能进行解绑定 EIP 操作。
InvalidParameter	参数取值不合法。
AddressQuotaLimitExceeded.DailyAllocate	重新分配普通公网 IP 配额已经到达当日配额上线。配额详情可通过 DescribeAddressQuota API 获取。

5. 示例代码

示例1

解绑 EIP ：

请求参数

  https://cvm.api.qcloud.com/v2/index.php?Action=DisassociateAddress
  &Version=2017-03-12
  &AddressId=eip-ek0cdz1g
  &<公共请求参数>

返回参数

{
    "Response": {
        "RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
    }
}

示例2

解绑 EIP 同时在解绑之后分配普通公网 IP：只有在该 EIP 绑定在主网卡的主内网 IP 上时才支持。

请求参数

  https://cvm.api.qcloud.com/v2/index.php?Action=DisassociateAddress
  &Version=2017-03-12
  &AddressId=eip-ek0cdz1g
  &ReallocateNormalPublicIp=TRUE
  &<公共请求参数>

返回参数

{
    "Response": {
        "RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
    }
}

上一篇: 绑定弹性公网IP 下一篇: 普通IP转弹性IP