调用ReleaseEipAddress接口释放指定的弹性公网IP(Elastic IP Address,简称EIP)。

使用说明

在调用本接口时,请了解以下内容:

  • 释放EIP前,请确保满足以下条件:
    • 只有处于Available状态的EIP才可以被释放。
    • 仅按量计费类型的EIP支持释放,包年包月类型的EIP不支持释放。
  • ReleaseEipAddress接口属于异步接口,即系统会先返回一个请求ID,但该EIP实例并未释放完成,系统后台的释放任务仍在进行。您可以调用DescribeEipAddresses查询EIP实例的状态:
    • 当EIP实例处于Releasing状态时,表示EIP实例正在释放中,在该状态下,您只能执行查询操作,不能执行其他操作。
    • 当查询不到该EIP实例时,表示EIP实例释放完成。
  • ReleaseEipAddress接口不支持并发释放同一个EIP实例。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ReleaseEipAddress

系统规定参数。取值:ReleaseEipAddress

RegionId String cn-hangzhou

要释放的EIP所在的地域ID。您可以通过调用DescribeRegions接口获取地域ID。

AllocationId String eip-2zeerraiwb7uj6i0d****

要释放的EIP的ID。

返回数据

名称 类型 示例值 描述
RequestId String 748C38F6-9A3D-482E-83FB-DB6C39C68AEA

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ReleaseEipAddress
&RegionId=cn-hangzhou
&AllocationId=eip-2zeerraiwb7uj6i0d****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ReleaseEipAddressResponse>
    <RequestId>748C38F6-9A3D-482E-83FB-DB6C39C68AEA</RequestId>
</ReleaseEipAddressResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "748C38F6-9A3D-482E-83FB-DB6C39C68AEA"
}

错误码

HttpCode 错误码 错误信息 描述
400 IncorrectEipStatus Current elastic IP status does not support this operation. 指定的EIP状态不支持此操作。
400 Forbidden.ChargeTypeIsPrepaid It's forbidden to release a prepaid EIP 预付费的 EIP 实例不能释放。
400 TaskConflict.AssociateGlobalAccelerationInstance Operate too frequent. 操作过于频繁。
400 Forbidden The eip instance owener error EIP 不属于当前调用者,请您检查该 EIP 是否可被您调用。
404 Forbidden.RegionNotFound Specified region is not found during access authentication. 指定 Region 不存在,请您检查该 Region 是否正确。
500 InternalError The request processing has failed due to some unknown error. 请求处理由于某些未知错误失败。

访问错误中心查看更多错误码。