调用 ReleaseEipAddress 接口，释放一个指定的公网IP。 ## 调用说明调用本接口释放公网IP，需要同时满足如下条件： * 公网IP为按量计费，或包月公网IP已到期。包年包月公网IP到期前，不支持调用本接口释放，若需要释放，请参考 [退订说明](https://www.volcengine.com/docs/6402/97754) 。 * 公网IP未绑定云资源。您可调用 [DescribeEipAddressAttributes](https://www.volcengine.com/docs/6402/71040) 接口，查看是否绑定云资源，若已绑定，可调用 [DisassociateEipAddress](https://www.volcengine.com/docs/6402/71037) 接口解绑。 * 公网IP未加入共享带宽包。您可调用 [DescribeEipAddressAttributes](https://www.volcengine.com/docs/6402/71040) 接口，查看是否已加入共享带宽包，若已加入，可调用 [RemoveBandwidthPackageIp](https://www.volcengine.com/docs/6623/100690) 接口从共享带宽包移出。 ## 调试 ## 请求参数 |参数名称 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |Action |String |是 |ReleaseEipAddress |要执行的操作，取值：ReleaseEipAddress。 | |Version |String |是 |2020\-04\-01 |API的版本信息，当前版本为2020\-04\-01。 | |AllocationId |String |是 |eip\-2zewb7ujxscd\*\*\*\* |要释放的公网IP的ID。|\ | | | | |您可以调用 [DescribeEipAddresses](https://www.volcengine.com/docs/6402/71035) 接口，查询公网IP的ID。 | |ClientToken |String |否 |123e4567\-e89b\-12d3\-a456\-42665544\*\*\*\* |保证请求幂等性。由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。取值：|\ | | | | ||\ | | | | |* 仅支持ASCII字符，且不能超过64个字符。 | ## 返回数据 |参数名称 |类型 |示例值 |描述 | |---|---|---|---| |RequestId |String |2021062415303301022514515207C4\*\*\*\* |请求ID。 | ## 请求示例 ```Plain Text GET /?Action=ReleaseEipAddress&Version=2020-04-01&AllocationId=eip-2zewb7ujxscd**** HTTP/1.1 Host: open.volcengineapi.com Service: vpc Region: cn-beijing ``` ## 返回示例 ```Plain Text { "ResponseMetadata": { "RequestId": "2021062415303301022514515207C4****", "Action": "ReleaseEipAddress", "Version": "2020-04-01", "Service": "vpc", "Region": "cn-beijing" }, "Result":{ "RequestId": "2021062415303301022514515207C4****" } } ``` ## 错误码公共错误码，请参见 [公共错误码](https://www.volcengine.com/docs/6402/71033) 。 |HttpCode |错误码 |错误信息 |描述 | |---|---|---|---| |400 |IdempotentParameterMismatch |Arguments on this idempotent request are inconsistent with arguments used in previous request(s). |此幂等请求的参数与前一个请求中使用的参数不一致。 | |400 |InvaildIpv6.NotSupport |The specified IPv6 address does not support this operation. |指定的IPv6地址不支持此操作。 | |400 |InvalidBillingType.Malformed |The specified billing type is malformed. |指定的计费方式不合法。 | |400 |InvalidEip.InTemporaryUpgrade |The specified eip is in temporary upgrade. |指定的EIP正在临时升配中。 | |400 |InvalidEip.InUse |The specified elastic ip is in use. |指定的公网IP使用中。 | |400 |InvalidEip.InUse |The specified EIP is being operated by another request. |指定的EIP正被另一个请求操作，请稍后再试。 | |400 |InvalidEip.InUse |The specified EIP has dependent resource of a bandwidth package. |指定的公网IP已加入到共享带宽包，无法释放。 | |400 |InvalidEipOrNat.InvalidStatus |The specified elastic ip or Nat is not in the correct status for the request. |指定的弹性公网IP或Nat网关所处的状态无法响应该请求。 | |400 |InvalidEip.InvalidStatus |The specified elastic ip is not in the correct status for the request. |指定的弹性公网IP所处的状态无法响应该请求。 | |400 |InvalidIPPool.InvalidStatus |The specified IP address pool is not in the correct status for the request. |指定IP地址池所处的状态无法响应该请求。 | |400 |InvalidNatGateway.InvalidStatus |The specified NAT gateway is not in the correct status for the request. |指定的NAT网关所处的状态无法响应该请求。 | |400 |InvalidNatGateway.UnSupportAction |The specified NAT gateway does not support this action. |指定的NAT网关不支持当前操作。 | |400 |InvalidParameter.ClientTokenMalformed |The specified parameter ClientToken is malformed. |指定的参数ClientToken格式不合法，长度不能超过64个ASCII字符。 | |400 |PreOrderError |Failed to create preorder. |创建配置单失败。 | |403 |Forbidden |You are not authorized to perform operations on the specified elastic ip and public CLB. |无权限操作此EIP和公网CLB。 | |403 |Forbidden |You are not authorized to disassociate elastic ip from Nat gateway. |无权限将EIP从Nat网关解绑。 | |403 |Forbidden |You are not authorized to perform operations on the specified elastic ip and ALB. |无权限操作此EIP和ALB。 | |403 |Forbidden |You are not authorized to perform operations on the specified elastic ip and private CLB. |无权限操作此EIP和私网CLB。 | |403 |Forbidden |You are not authorized to perform operations on the specified elastic network interface. The specified elastic network interface is a service\-managed elastic network interface. |无权限对指定弹性网卡进行操作。指定的弹性网卡为云产品托管的弹性网卡。 | |404 |InvalidIPPool.NotFound |The specified IP address pool does not exist. |指定的IP地址池不存在。 | |404 |InvalidInstance.NotFound |The specified instance does not exist. |指定的实例不存在。 | |404 |InvalidEip.GetInstanceDetail |Get instance detail failed |获取实例信息失败 | |404 |InvalidEip.NotFound |The specified EIP does not exist. |指定的公网IP不存在。 | |404 |InvalidNatBindEip.NotFound |The specified eip bound with nat does not exist. |指定的NAT关联EIP不存在。 | |404 |InvalidNatGateway.NotFound |The specified NAT gateway does not exist. |指定的NAT网关不存在。 | |412 |IdempotentProcessing |The request uses the same client token as a previous one that is still in process. |幂等请求处理中。 |