Related command
az network route-table route and az network manager routing-config rule-collection rule
Is your feature request related to a problem? Please describe.
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.
Describe the solution you'd like
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.
Describe alternatives you've considered
Users can use az rest to call the API directly, but native CLI support is preferred for discoverability and usability.
Additional context
Related command
az network route-table routeandaz network manager routing-config rule-collection ruleIs your feature request related to a problem? Please describe.
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
VirtualApplianceEcmphas been added toRouteNextHopType. When used, routes include a newnextHopproperty (type:RouteNextHopEcmp) containing anextHopIpAddressesarray (minimum 2 IPs) for load-balancing traffic across multiple virtual appliance instances. This should be supported inaz network route-table route create/update/show/list.Network Manager Routing Configuration: The existing
nextHopAddressproperty inRoutingRuleNextHopnow supports comma-separated IP addresses (e.g.,"10.1.0.4,10.1.0.5,10.1.0.6") for ECMP whennextHopTypeisVirtualAppliance. This should be documented and visible inaz network manager routing-config rule-collection rule create/show/list.Describe the solution you'd like
az network route-table route create/updateshould accept--next-hop-type VirtualApplianceEcmpand a new--next-hop-ip-addressesparameter accepting a space-separated list of IPs (minimum 2).az network route-table route show/listshould display thenextHop.nextHopIpAddressesarray in the output for ECMP routes.az network manager routing-config rule-collection rule createshould accept comma-separated IP addresses in the--next-hop-addressparameter when--next-hop-typeisVirtualAppliance.az network manager routing-config rule-collection rule show/listshould display the comma-separatednextHopAddressin the output.Describe alternatives you've considered
Users can use
az restto call the API directly, but native CLI support is preferred for discoverability and usability.Additional context
Microsoft.Network/routeTables/routesandMicrosoft.Network/networkManagers/routingConfigurations/ruleCollections/rules