[Network] Add ECMP routing support for route tables

[nandakishores]

Preconditions

• No need to upgrade Python SDK or the Python SDK is ready.

Related command

az network route-table route and az network manager routing-config rule-collection rule

• az network route-table route create/update should accept --next-hop-type VirtualApplianceEcmp and a new --next-hop-ip-addresses parameter accepting a space-separated list of IPs (minimum 2).
• az network route-table route show/list should display the nextHop.nextHopIpAddresses array in the output for ECMP routes.
• az network manager routing-config rule-collection rule create should accept comma-separated IP addresses in the --next-hop-address parameter when --next-hop-type is VirtualAppliance.
• az network manager routing-config rule-collection rule show/list should display the comma-separated nextHopAddress in the output.

Resource Provider

Microsoft.Network/resource-manager

Description of Feature or Work Requested

The Azure Network RP is adding ECMP (Equal-Cost Multi-Path) routing support to Route Tables and Network Manager Routing Configuration resources in API version 2025-07-01. The CLI commands do not yet expose these new capabilities:

Route Tables: A new next hop type VirtualApplianceEcmp has been added to RouteNextHopType. When used, routes include a new nextHop property (type: RouteNextHopEcmp) containing a nextHopIpAddresses array (minimum 2 IPs) for load-balancing traffic across multiple virtual appliance instances. This should be supported in az network route-table route create/update/show/list.

Network Manager Routing Configuration: The existing nextHopAddress property in RoutingRuleNextHop now supports comma-separated IP addresses (e.g., "10.1.0.4,10.1.0.5,10.1.0.6") for ECMP when nextHopType is VirtualAppliance. This should be documented and visible in az network manager routing-config rule-collection rule create/show/list.

Minimum API Version Required

2025-07-01

Swagger PR link / SDK link

[Swagger PR: Add ECMP routing support for Route Tables and Network Manager Routing Configuration azure-rest-api-specs#{ 40820}](Azure/azure-rest-api-specs#40820)

Request Example

routeTable.json — RouteNextHopEcmp definition
networkManagerRoutingConfiguration.json — ECMP nextHopAddress

Target Date

2025-07-01

PM Contact

lijay@microsoft.com

Engineer Contact

nsiddabasapp@microsoft.com

Additional context

• Swagger PR: Add ECMP routing support for Route Tables and Network Manager Routing Configuration azure-rest-api-specs#{ 40820}
• API version: 2025-07-01
• Target resource types: Microsoft.Network/routeTables/routes and Microsoft.Network/networkManagers/routingConfigurations/ruleCollections/rules

[yonzhan]

Thank you for opening this issue, we will look into it.

[github-actions]

Here are some similar issues that might help you. Please check if they can solve your problem.

• Add ECMP routing support for Route Tables and Network Manager Routing Configuration for API version 2025-07-01 #32862

Powered by issue-sentinel