调用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的实例配额。 |
访问错误中心查看更多错误码。