调用UnassociateHaVip接口解绑与HaVip绑定的专有网络ECS实例或弹性网卡。

使用说明

在调用本接口创建高可用虚拟IP时,请注意:

  • 要解绑的ECS实例的状态必须为运行中停止
  • 要解绑的HaVip实例状态必须为AvailableInUse
  • UnassociateHaVip接口属于异步接口,即系统会返回一个请求ID,但该HaVip尚未解绑成功,系统后台的解绑任务仍在进行。您可以调用DescribeHaVips查询HaVip的解绑状态:
    • 当HaVip处于Unassociating状态时,表示HaVip正在解绑中。
    • 当HaVip处于Inuse或者Available状态时,表示HaVip解绑成功。
  • UnassociateHaVip接口不支持并发解绑同一个HaVip。

调试

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

请求参数

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

系统规定参数。取值:UnassociateHaVip

ClientToken String 0c593ea1-3bea-11e9-b96b-88e9fe63****

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。

RegionId String cn-shanghai

HaVip实例所在的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

HaVipId String havip-2zeo05qre24nhrqpy****

要解绑的HaVip实例ID。

InstanceId String i-faf344422ffsfad****

与HaVip解绑的ECS实例ID或弹性网卡实例ID。

Force String True

是否强制解绑与HaVip绑定的ECS实例或弹性网卡实例,取值:

  • True:强制解绑。
  • False (默认值):不强制解绑。
说明 如果该参数取值为False,无法解绑HaVip绑定的主实例。
InstanceType String EcsInstance

要解绑HaVip的实例类型,取值:

  • EcsInstance:云服务器ECS实例。
  • NetworkInterface:弹性网卡实例。
说明 当要解绑的实例为弹性网卡时,该参数必须填写。

返回数据

名称 类型 示例值 描述
RequestId String C44F62BE-9CE7-4277-B117-69243F3988BF

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=UnassociateHaVip
&ClientToken=0c593ea1-3bea-11e9-b96b-88e9fe63****
&RegionId=cn-shanghai
&HaVipId=havip-2zeo05qre24nhrqpy****
&InstanceId=i-faf344422ffsfad****
&Force=True
&InstanceType=EcsInstance
&公共请求参数

正常返回示例

XML格式

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

<UnassociateHaVipResponse>
    <RequestId>C44F62BE-9CE7-4277-B117-69243F3988BF</RequestId>
</UnassociateHaVipResponse>

JSON格式

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

{
  "RequestId" : "C44F62BE-9CE7-4277-B117-69243F3988BF"
}

错误码

HttpCode 错误码 错误信息 描述
400 IncorrectHaVipStatus HaVip can be operated by this action only when it's status is InUse. 只有当HAVIP的状态是InUse时,才可以执行该操作。
400 IncorrectInstanceStatus ECS instance can be operated by this action only when it's status is Running or Stopped. 只有当ECS实例的状态为运行中或者停止状态时,才可执行该操作。
400 ResourceNotAssociated The HaVip and ECS instance are not associated. HAVIP和ECS没有绑定。
400 Forbidden.UnassociateMaster Unassociating a master instance is not allowed unless the parameter Force is True. 非强制解绑时,不允许解绑master实例。
400 OperationFailed.QueryNetworkInterfaceInfo Failed to query network interface information. 查询网卡信息失败。
400 IllegalParam.InstanceType The specified instance type is invalid. Only ECS instances and network interface are allowed. 绑定的实例类型不允许。
400 InvalidNetworkInterfaceId.NotFound The network interface is not found. 网卡不存在。
400 ResourceNotFound.Instance The specified binding resource is not found. 绑定资源不存在。
404 InvalidHaVipId.NotFound The specified HaVip does not exist in the specified region. 指定的HaVip不在指定的地域中,请您检查选择的地域是否正确。
404 InvalidInstanceId.NotFound The specified Instance does not exist in the specified region. 该实例在该地域内不存在。
500 InternalError The request processing has failed due to some unknown error. 请求处理由于某些未知错误失败。

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