You need to enable JavaScript to run this app.
导航

DisassociateHaVip

最近更新时间2024.01.10 10:41:31

首次发布时间2022.03.01 09:03:59

调用 DisassociateHaVip 接口,将高可用虚拟IP(HAVIP)从云服务器实例或网卡上解绑。

说明

高可用虚拟IP功能正在邀测中,如需使用该接口,请提交工单或联系客户经理申请。

调试

请求参数

参数名称
类型
是否必选
示例值
描述
ActionStringDisassociateHaVip要执行的操作,取值:DisassociateHaVip。
VersionString2020-04-01API版本信息,取值为:2020-04-01。

HaVipId

String

havip-2zeo05qre24nhrqpy****

要解绑的高可用虚拟IP的ID。
您可以调用 DescribeHaVips 接口,查询高可用虚拟IP的ID。

InstanceType

String

EcsInstance

要解绑高可用虚拟IP的实例类型。

  • EcsInstance:云服务器实例
  • NetworkInterface:网卡

InstanceId

String

i-faf344422ffsfad****

要解绑高可用虚拟IP的实例的ID。
您可以调用 DescribeInstancesDescribeNetworkInterfaces 接口,查询云服务器实例的ID或网卡的ID。

ClientToken

String

123e4567-e89b-12d3-a456-42665544****

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

  • 由客户端自动生成一个参数值,确保不同请求间该参数值唯一,避免当调用API超时或服务器内部错误时,客户端多次重试导致重复性操作。
  • 仅支持ASCII字符,且不能超过64个字符。
  • 若不传入ClientToken,则此次API调用不进行幂等校验。

返回数据

参数名称
类型
示例值
描述
RequestIdString473469C7-AA6F-4DC5-B3DB-A3DC0DE3****请求ID。

请求示例

GET /?Action=DisassociateHaVip&Version=2020-04-01&HaVipId=havip-2zeo05qre24nhrqpy****&InstanceId=i-faf344422ffsfad****&InstanceType=EcsInstance HTTP/1.1
Host: open.volcengineapi.com   
Service: vpc
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
        "Action": "DisassociateHaVip",
        "Version": "2020-04-01",
        "Service": "vpc",
        "Region": "cn-beijing"
    },
    "Result": {
        "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
    }
}

错误码

此处仅展示当前API的错误码,更多错误码请参见公共错误码

HttpCode
错误码
错误信息
描述
400IdempotentParameterMismatchArguments on this idempotent request are inconsistent with arguments used in previous request(s).此幂等请求的参数与前一个请求中使用的参数不一致。
400InvalidHaVip.InstanceMismatchThe specified HaVip and instance are not associated.指定的高可用虚拟IP和实例没有绑定关系。
400InvalidHaVip.InvalidStatusThe specified HaVip is not in the correct status for the request.指定的高可用虚拟IP所处状态无法响应该请求。
400InvalidHaVip.NotSupportThe specified HaVip does not support this operation指定的高可用虚拟IP不支持此操作。
400InvalidParameter.ClientTokenMalformedThe specified parameter ClientToken is malformed.指定的参数ClientToken格式不合法,长度不能超过64个ASCII字符。
403ForbiddenYou are not authorized to perform operations on the specified elastic network interface. The specified elastic network interface is a service-managed elastic network interface.无权限对指定弹性网卡进行操作。指定的弹性网卡为云产品托管的弹性网卡。
404InvalidHaVip.NotFoundThe specified HaVip does not exist.指定的高可用虚拟IP不存在。
412IdempotentProcessingThe request uses the same client token as a previous one that is still in process.幂等请求处理中。