Associates a high-availability virtual IP address (HAVIP) with an Elastic Compute Service (ECS) instance or an elastic network interface (ENI) in a virtual private cloud (VPC).

Limits

When you call this operation, take note of the following limits:

  • The HAVIP takes effect immediately after it is associated with an ECS instance in a VPC. You do not need to restart the ECS instance. However, you must associate the HAVIP with the ENI of the ECS instance.
  • The HAVIP and ECS instance must belong to the same vSwitch.
  • You can associate an HAVIP with at most two ECS instances.
  • The ECS instance must be in the Running or Stopped state.
  • The HAVIP must be in the Available or InUse state.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes AssociateHaVip

The operation that you want to perform. Set the value to AssociateHaVip.

HaVipId String Yes havip-2zeo05qre24nhrqpy****

The ID of the HAVIP.

InstanceId String Yes i-faf344422ffsfad****

The ID of the ECS instance to be associated with the HAVIP.

RegionId String Yes cn-shanghai

The ID of the region to which the HAVIP belongs.

You can call the DescribeRegions operation to query the most recent region list.

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

The client token that is used to ensure the idempotency of the request. You can use the client to generate the value, but you must make sure that it is unique among different requests. ClientToken can contain only ASCII characters and cannot exceed 64 characters in length.

InstanceType String No EcsInstance

The type of the instance to be associated with the HAVIP. Valid values:

  • EcsInstance: an ECS instance
  • NetworkInterface: an ENI. If you want to associate the HAVIP with an ENI, this parameter is required.

Response parameters

Parameter Type Example Description
RequestId String C44F62BE-9CE7-4277-B117-69243F3988BF

The ID of the request.

Examples

Sample requests

https://vpc.aliyuncs.com/?Action=AssociateHaVip
&HaVipId=havip-2zeo05qre24nhrqpy****
&InstanceId=i-faf344422ffsfad****
&RegionId=cn-shanghai
&<Common request parameters>

Sample success responses

XML format

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

JSON format

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

Error codes

HttpCode Error code Error message Description
404 InvalidHaVipId.NotFound The specified HaVip does not exist in the specified region. The error message returned because the specified HAVIP does not exist in the specified region. Check whether the region ID is valid.
404 InvalidInstanceId.NotFound The specified Instance does not exist in the specified region. The error message returned because the instance does not exist in the specified region.
400 IncorrectHaVipStatus HaVip can be operated by this action only when it's status is Available or InUse. The error message returned because this operation can be performed only when the HAVIP is in the Available or InUse state.
400 CountLimitExceed.HaVipOnInstance The amount of HaVip associated with the specified Instance reach its limits. The error message returned because the number of HAVIPs has reached the upper limit.
400 CountLimitExceeded.HaVipOnECSInstance The amount of Instance associated with the specified HaVip reach its limits. The error message returned because the number of HAVIPs has reached the upper limit.
400 OperationUnsupported.BindMultipleType You cannot bind HaVip to multiple instance types. The error message returned because you cannot associate the ECS instance and the ENI at the same time.
400 InvalidNetworkInterfaceId.NotFound The network interface is not found. The error message returned because the ENI does not exist.
400 OperationUnsupported.BindOnMultipleVswitch The bound instance and HaVip must be on the same vSwitch. The error message returned because the instance and HAVIP that you want to associate must belong to the same vSwitch.
400 OperationUnsupported.BindOnFreeNetworkInterface The network interface must be attached to an ECS instance. The error message returned because the ENI must be associated with the ECS instance.
400 OperationFailed.QueryNetworkInterfaceInfo Failed to query network interface information. The error message returned because the system failed to query ENI information.
400 IllegalParam.InstanceType The specified instance type is invalid. Only ECS instances and network interface are allowed. The error message returned because the type of the associated instance does not support this operation.
400 OperationUnsupported.BindOnSameEcs You cannot bind two network interfaces on the same ECS instance. The error message returned because you are not allowed to associate two ENIs of the same ECS instance.
400 OperationUnsupported.HavipBindType You cannot bind HAVIP to network interface in the specified region. The error message returned because you are not allowed to associate ENIs in the specified region.

For a list of error codes, visit the API Error Center.