Azure ExpressRoute 网关迁移 - 排查错误和最佳做法

本文概述了与网关迁移工作流关联的错误代码及其原因和解决方法。 迁移过程的每个阶段通常发生的问题: 验证准备迁移提交或中止

避免迁移错误的最佳做法

按照以下最佳做法在网关迁移过程中最大程度地减少错误:

  • 维护资源运行状况:确保所有资源在迁移过程中保持 成功 状态。 避免在此过程中对相关资源运行更新。

  • 避免属性更新:避免更新 FastPath路由权重或连接和网关的 流量切换 等属性,因为这些更新可能会导致资源故障。

  • 顺序网关迁移:迁移一次连接到同一线路的网关。 不支持同一线路上的并行迁移。

  • 避免手动更改:避免在迁移过程中主动承载流量(管理员状态)时手动创建、删除、更新或重置网关或其连接。

  • 检查是否在维护中:避免创建连接到进行维护的网关,因为此操作会失败。 在重试之前,必须删除任何失败的连接。

通过遵循这些做法,可以减少在迁移过程中遇到错误的可能性。

迁移阶段的常见问题及其解决方法

下表概述了在每个迁移阶段遇到的常见问题,并提供解决这些问题的策略:

迁移阶段 問题 决议
验证 资源未处于成功状态。 若要解决此问题,请对受影响的资源执行 GET 和 SET 操作。
准备 创建新资源失败。 重试操作。 如果重试继续失败,请删除新创建的资源,然后再次尝试该作。
迁移 迁移失败后,这两个网关仍保持启用状态。 将流量重定向回旧网关,然后重试迁移过程。
提交 旧网关保持启用状态,提交步骤失败。 重试迁移步骤。 成功禁用旧网关后,删除旧网关及其关联的资源。
中止 在中止步骤中清理资源失败。 将流量重定向到新网关,然后重试中止操作。

常见错误消息

下表概述了在迁移过程中遇到的常见错误消息及其原因和解决方法:

条件支持的方案

这些方案包括用于防止故障的解决方案,并确保成功迁移。

错误名称 消息 决议
网关子网大小不足 虚拟网络 {vnetName} 没有足够的空间来部署另一个网关。 删除并重新创建 GatewaySubnet 作为 /27 或较短的前缀(例如 /26 或 /25)。 有关指南,请参阅 “删除并重新创建子网”。
旧连接模式 链接到网关的 ExpressRoute 连接是在 2017 年之前创建的(旧模式)。 在启动迁移之前删除并重新创建所有连接。 有关详细步骤,请参阅 “转换旧版 ExpressRoute 网关连接”。
处于失败状态的资源 如果网关或任何连接的资源(如线路、连接、公共 IP、VNet 或 GatewaySubnet)处于失败状态, 则验证 阶段将失败。 在启动迁移过程之前,验证所有资源是否处于成功状态。 有关详细信息,请参阅排查失败状态
默认网关 SKU 限制 在迁移之前,必须将默认网关升级到标准 SKU,以确保区域复原能力。 在继续迁移之前,将网关 SKU 更改为“标准”。 有关详细信息,请参阅调整网关 SKU 的大小
FastPath 配置限制 不支持在迁移期间启用或禁用 FastPath。 在继续迁移之前,请确保 FastPath 保留在其原始配置中。
路由权重修改限制 不允许在迁移期间调整路由权重。 在继续迁移过程之前,将路由权重还原为其原始值。

需要避免的不受支持的情况

下表概述了可能导致迁移失败且没有可用解决方法的不受支持的方案:

错误名称 消息 原因
在 VNet 中已达到网关数量的最大限制 虚拟网络 {virtualNetworkName} 的操作失败,因为它已达到允许的最大网关数量。 虚拟网络不能部署两个以上的 ExpressRoute 网关。
超出连接限制 现有网关具有 {connectionCount} 连接,超过新网关大小 {circuitLimit}{gatewaySize} 连接限制。 不允许迁移到连接限制低于现有连接限制的网关。 不支持 SKU 类型的降级。
FastPath 限制 网关大小 {gatewaySize} 不支持 ExpressRouteGatewayByPass。 连接到已启用 FastPath 连接的网关只能迁移到 UltraPerf 或 ERGW3AZ SKU。 不支持 SKU 类型的降级。
撤销的线路授权 虚拟网络 {virtualNetworkName} 的操作失败,因为它已达到允许的最大网关数量。 连接到具有已撤销授权的线路的网关无法继续迁移。

后续步骤