调用UnassociateEipAddress将弹性公网IP(EIP)从绑定的云产品上解绑。

使用说明

  • UnassociateEipAddress接口属于异步接口,即系统会先返回一个请求ID,但EIP并未完成解绑,系统后台的解绑任务仍在进行。您可以调用DescribeEipAddresses查询EIP的状态:
    • 当EIP处于Unassociating状态时,表示EIP正在解绑中,在该状态下,您只能执行查询操作,不能执行其他操作。
    • 当EIP处于Available时,表示EIP完成解绑。
  • UnassociateEipAddress接口不支持并发解绑同一个EIP。

调试

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

请求参数

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

系统规定参数。取值:UnassociateEipAddress

Force Boolean false

当EIP绑定了NAT网关,且NAT网关添加了DNAT或SNAT条目时,是否强制解绑EIP,取值:

  • false(默认值):不强制解绑EIP。
  • true:强制解绑EIP。
RegionId String cn-hangzhou

要解绑的EIP的地域ID。

AllocationId String eip-2zeerraiwb7uj6i0d****

要解绑的EIP的ID。 您可以通过调用DescribeRegions接口获取地域ID。

InstanceId String i-hp3akk9irtd69jad****

要解绑EIP的云产品实例的ID。

InstanceType String EcsInstance

要解绑EIP的云产品类型,取值:

  • EcsInstance(默认值):专有网络类型的ECS实例。
  • SlbInstance:专有网络类型的SLB实例。
  • NetworkInterface:专有网络类型的辅助弹性网卡。
  • Nat:NAT网关。
  • HaVip:高可用虚拟IP。
PrivateIpAddress String 192.XX.XX.2

要解绑EIP的ECS实例或辅助弹性网卡实例的私网IP地址。

ClientToken String 02fb3da4-130e-11****

客户端Token,用于保证请求的幂等性。

从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。

说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。

返回数据

名称 类型 示例值 描述
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=UnassociateEipAddress
&Force=false
&RegionId=cn-hangzhou
&AllocationId=eip-2zeerraiwb7uj6i0d****
&InstanceId=i-hp3akk9irtd69jad****
&InstanceType=EcsInstance
&PrivateIpAddress=192.XX.XX.2
&ClientToken=02fb3da4-130e-11****	
&公共请求参数

正常返回示例

XML格式

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

<UnassociateEipAddressResponse>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</UnassociateEipAddressResponse>

JSON格式

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

{
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

错误码

HttpCode 错误码 错误信息 描述
400 IncorrectEipStatus Current elastic IP status does not support this operation. 指定的EIP状态不支持此操作。
400 InvalidInstanceId.NotFound Specified instance does not exist. 该实例不存在,请您检查填写的实例是否正确。
400 IncorrectInstanceStatus The current status of instance does not support this operation. 当前实例的状态不支持该操作。
400 InvalidInstanceType.ValueNotSupported The specified value of InstanceType is not supported. 参数InstanceType的值不合法。
400 IncorrectHaVipStatus This operation is denied because satus of the specified HaVip is neither Available nor InUse. 无法执行该操作,因为HaVip的状态是Available或InUse。
400 OperationDenied Eip of default vpc not allow this operation 默认专有网络的EIP不支持该操作。
400 InvalidParameter The specified parameter is not valid. 该参数值不合法。
400 Forbbiden The eip instance owener error EIP 不属于当前调用者,请您检查该 EIP 是否可被您调用。
400 InvalidBindingStatus The eip binding status invalid. EIP绑定状态不正确。
404 InvalidAllocationId.NotFound Specified allocation ID is not found 指定的公网 IP 不存在,请您检查您填写的参数是否正确。
404 Forbidden.RegionNotFound Specified region is not found during access authentication. 指定 Region 不存在,请您检查该 Region 是否正确。

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