调用ReleaseEipAddress接口释放指定的弹性公网IP(EIP)。

API描述

释放EIP前,请确保满足以下条件:

  • 只有处于Available状态的EIP才可以被释放。
  • 仅按量计费类型的EIP支持释放,包年包月类型的EIP不支持释放。

调试

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

请求参数

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

要执行的操作,取值:ReleaseEipAddress

AllocationId String eip-2zeerraiwb7uj6i0d****

要释放的EIP的ID。

RegionId String cn-hangzhou

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

返回数据

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

请求ID。

示例

请求示例

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

正常返回示例

XML格式

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

JSON格式

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

错误码

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

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