文档中心

消息队列 RocketMQ版

实例连接管理

切换子网

为实例绑定私有网络 VPC 和子网之后，您可以根据业务需求在 VPC 网络内切换子网。本文档介绍 VPC 网络内切换子网的操作步骤。

背景信息

为实例绑定私有网络 VPC 和子网之后，如果需要重新进行业务网络规划或网络切换，您可以在 VPC 网络内为 RocketMQ 实例切换子网，为实例绑定另外一个子网。成功切换子网后，实例的所有内网接入点对应的 IP 地址都会切换为新子网中的另一个内网 IP 地址，切换内网 IP 地址将导致实例重启，可能会造成较长时间的断流。

前提条件

已在同一 VPC 内创建了新的子网，子网中有至少 6 个空闲的内网 IP 地址。

注意事项

警告

替换子网会导致断流，不建议生产业务直接更换子网。

暂不支持切换 VPC。切换子网时，只能选择同一 VPC 网络下的其他子网。

RocketMQ 实例的接入点（连接地址）为域名形式，切换子网会变更域名对应的内网 IP 地址，请注意清理客户端的 DNS 缓存。切换子网后请仔细确认接入点是否有变化，确保使用的接入点和切换完成最终展示的保持一致。

开始切换子网时，RocketMQ 实例会记录一个后台任务，并显示在后台任务列表中，您可以及时查看子网切换的进度。详细说明请参考后台任务管理。

切换过程中，RocketMQ 客户端会和部分节点断开连接，请确保业务具备自动重连机制。

操作步骤

登录消息队列 RocketMQ版控制台。

在实例列表页面，单击目标实例名称。

在实例详情页签的基本信息区域，找到子网一栏，并单击修改。

在弹出对话框中重新选择子网。

如果没有合适的子网，可根据页面提示创建一个新的子网。

单击确定。

最近更新时间：2025.12.25 18:29:46

这个页面对您有帮助吗？

有用

无用