文档首页> 虚拟私有云 VPC> API参考> 应用示例> 示例三：配置云服务器高可用的虚拟IP功能

更新时间：2022-09-22 GMT+08:00

在线调试

CLI示例

查看PDF

示例三：配置云服务器高可用的虚拟IP功能

操作场景

虚拟IP主要用在弹性云服务器的主备切换，达到高可用性的目的。当主服务器发生故障无法对外提供服务时，动态将虚拟IP切换到备服务器，继续对外提供服务。

本章节指导用户通过调用一系列虚拟IP相关API，使应用具备高可用性。

前提条件

已创建VPC和子网，并获取VPC和子网的ID，具体请参见创建VPC和子网。
已创建弹性云服务器，具体请参见创建ECS。
当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。Token认证，具体操作请参考认证鉴权。

通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。

操作步骤

创建虚拟IP。

发送“POST https://VPC的Endpoint/v2.0/ports”。
在Request Header中增加“X-Auth-Token”。

在Request Body中传入参数如下，其中vip所在子网需与ECS同子网。

{
	"port": {
		"network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
		"device_owner": "neutron:VIP_PORT",
		"name": "vip_port_test"
	}
}

或者如下，可以指定IP创建：

{
	"port": {
		"network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
		"device_owner": "neutron:VIP_PORT",
		"name": "vip_port_test",
		"fixed_ips": [
			{
				"ip_address": "192.168.0.220"
			}
		]
	}
}

查看请求响应结果。

请求成功时，响应参数如下：

{
	"port": {
		"id": "a7d98f3c-b42f-460b-96a1-07601e145961",
		"name": "port-test",
		"status": "DOWN",
		"admin_state_up": true,
		"fixed_ips": [{
			"subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12",
			"ip_address": "192.168.0.220"
		}],
		"mac_address": "fa:16:3e:01:f7:90",
		"network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
		"tenant_id": "db82c9e1415a464ea68048baa8acc6b8",
		"project_id": "db82c9e1415a464ea68048baa8acc6b8",
		"device_id": "",
		"device_owner": "neutron:VIP_PORT",
		"security_groups": ["d0d58aa9-cda9-414c-9c52-6c3daf8534e6"],
		"extra_dhcp_opts": [],
		"allowed_address_pairs": [],
		"binding:vnic_type": "normal",
		"binding:vif_details": {},
		"binding:profile": {},
		"port_security_enabled": true,
		"created_at": "2018-09-20T01:45:26",
		"updated_at": "2018-09-20T01:45:26"
	}
}

请求异常时，错误码请参见错误码。

通过云服务器的ID查询网卡信息。

发送“GET https://VPC的Endpoint/v2.0/ports?device_id={ecs_id}&network_id={network_id}”
在Request Header中增加“X-Auth-Token”。

查看请求响应结果。

请求成功时，响应参数如下：

{
	"ports": [{
		"id": "02c72193-efec-42fb-853b-c33f2b802467",
		"name": "",
		"status": "ACTIVE",
		"admin_state_up": true,
		"fixed_ips": [{
			"subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12",
			"ip_address": "192.168.0.75"
		}],
		"mac_address": "fa:16:3e:47:5f:c1",
		"network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
		"tenant_id": "db82c9e1415a464ea68048baa8acc6b8",
		"project_id": "db82c9e1415a464ea68048baa8acc6b8",
		"device_id": "ea61f836-b52f-41bf-9d06-685644001d6f",
		"device_owner": "compute:br-iaas-odin1a",
		"security_groups": [
			"e0598d96-9451-4f8a-8de0-b8b4d451d9e7"
		],
		"extra_dhcp_opts": [],
		"allowed_address_pairs": [],
		"binding:vnic_type": "normal",
		"binding:vif_details": {
			"primary_interface": true
		},
		"binding:profile": {},
		"port_security_enabled": true,
		"created_at": "2020-06-20T08:07:29",
		"updated_at": "2020-06-20T08:07:29"
	}]
}

请求异常时，错误码请参见错误码。

将云服务器与虚拟IP绑定。

发送“PUT https://VPC的Endpoint/v2.0/ports/{port_id}”。port_id为上面创建的虚拟IP对应的port_id。
在Request Header中增加“X-Auth-Token”。
在Request Body中传入参数如下，ip_address为2查询出的云服务器的网卡ip。
```
{
	"port": {
		"allowed_address_pairs": [{
			"ip_address": "192.168.0.75"
		}]
	}
}
```

查看请求响应结果。

请求成功时，响应参数如下：

{
	"port": {
		"id": "a7d98f3c-b42f-460b-96a1-07601e145961",
		"name": "port-test",
		"status": "DOWN",
		"admin_state_up": true,
		"fixed_ips": [{
			"subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12",
			"ip_address": "192.168.0.220"
		}],
		"mac_address": "fa:16:3e:01:f7:90",
		"network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
		"tenant_id": "db82c9e1415a464ea68048baa8acc6b8",
		"project_id": "db82c9e1415a464ea68048baa8acc6b8",
		"device_id": "",
		"device_owner": "neutron:VIP_PORT",
		"security_groups": ["d0d58aa9-cda9-414c-9c52-6c3daf8534e6"],
		"extra_dhcp_opts": [],
		"allowed_address_pairs": [{
			"ip_address": "192.168.0.75"
		}]
		"binding:vnic_type": "normal",
		"binding:vif_details": {},
		"binding:profile": {},
		"port_security_enabled": true,
		"created_at": "2018-09-20T01:45:26",
		"updated_at": "2018-09-20T01:45:26"
	}
}

请求异常时，错误码请参见错误码。

关闭云服务器网卡的源/目的检查。

发送“PUT https://VPC的Endpoint/v2.0/ports/{port_id}”。port_id为2查询到的网卡ID。
在Request Header中增加“X-Auth-Token”。
在Request Body中传入参数如下：ip_address为1.1.1.1/0查询出的云服务器的网卡ip。
```
{
	"port": {
		"allowed_address_pairs": [{
			"ip_address": "1.1.1.1/0"
		}]
	}
}
```

查看请求响应结果。

请求成功时，响应参数如下：

{
	"port": {
		"id": "02c72193-efec-42fb-853b-c33f2b802467",
		"name": "",
		"status": "ACTIVE",
		"admin_state_up": true,
		"fixed_ips": [{
			"subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12",
			"ip_address": "192.168.0.75"
		}],
		"mac_address": "fa:16:3e:47:5f:c1",
		"network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
		"tenant_id": "db82c9e1415a464ea68048baa8acc6b8",
		"project_id": "db82c9e1415a464ea68048baa8acc6b8",
		"device_id": "ea61f836-b52f-41bf-9d06-685644001d6f",
		"device_owner": "compute:br-iaas-odin1a",
		"security_groups": ["e0598d96-9451-4f8a-8de0-b8b4d451d9e7"],
		"extra_dhcp_opts": [],
		"allowed_address_pairs": [{
			"ip_address": "1.1.1.1/0"
		}],
		"binding:vnic_type": "normal",
		"binding:vif_details": {
			"primary_interface": true
		},
		"binding:profile": {},
		"port_security_enabled": true,
		"created_at": "2020-06-20T08:07:29",
		"updated_at": "2020-06-20T08:07:29"
	}
}

请求异常时，错误码请参见错误码。

父主题： 应用示例

上一篇：示例二：配置云服务器的访问策略

下一篇：示例四：配置云服务器高可用的IPv6虚拟IP功能

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

示例三：配置云服务器高可用的虚拟IP功能

操作场景

前提条件

操作步骤

相关文档

相关产品

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线