调用AssociateHaVip接口将HaVip绑定到专有网络ECS实例上。
在调用本接口创建高可用虚拟IP时，请注意：
- HaVip绑定后立即生效，无需重启ECS实例。但需要将HaVip配置到上实例网卡上。
- HaVip和要绑定的ECS实例必须同属于一个交换机。
- 一个HaVip最多可绑定两个ECS实例。
- 要绑定的ECS实例的状态必须为运行中或停止。
- HaVip实例的状态必须为Available或InUse。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | AssociateHaVip |
要执行的操作，取值：AssociateHaVip。 |
| HaVipId | String | 是 | havip-2zeo05qre24nhrqpy**** |
与ECS实例绑定的HaVip实例ID。 |
| InstanceId | String | 是 | i-faf344422ffsfad**** |
与HaVip实例绑定的ECS实例ID。 |
| RegionId | String | 是 | cn-shanghai |
HaVip实例所在的地域。 您可以通过调用DescribeRegions接口获取地域ID。 |
| ClientToken | String | 否 | 0c593ea1-3bea-11e9-b96b-88e9fe637760 |
保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字 符，且不能超过64个字符。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | C44F62BE-9CE7-4277-B117-69243F3988BF |
请求ID。 |
示例
请求示例
https://vpc.aliyuncs.com/?Action=AssociateHaVip
&HaVipId=havip-2zeo05qre24nhrqpy****
&InstanceId=i-faf344422ffsfad****
&RegionId=cn-shanghai
&<公共请求参数>正常返回示例
XML 格式
<AssociateHaVipResponse>
<RequestId>C44F62BE-9CE7-4277-B117-69243F3988BF</RequestId>
</AssociateHaVipResponse>JSON 格式
{
"RequestId": "C44F62BE-9CE7-4277-B117-69243F3988BF"
}错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 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. | 该实例在该地域内不存在。 |
| 400 | IncorrectHaVipStatus | HaVip can be operated by this action only when it's status is Available or InUse. | 只有当HAVIP的状态是Available或InUse时，才可以执行该操作。 |
| 400 | CountLimitExceed.HaVipOnInstance | The amount of HaVip associated with the specified Instance reach its limits. | 超过实例的HAVIP配额。 |
| 400 | CountLimitExceeded.HaVipOnECSInstance | The amount of Instance associated with the specified HaVip reach its limits. | 超过HAVIP的实例配额。 |
访问错误中心查看更多错误码。