Azure CLI更新AKS出口类型为UserDefinedRouting时参数异常问题

问题原因 #

你遇到的核心问题是：--vnet-subnet-id是AKS集群创建阶段的专属参数，az aks update命令并不支持该参数。第一次报错是因为集群所在子网未关联配置好出口规则的用户定义路由表（UDR），而你错误地用创建命令的参数来尝试解决更新时的提示。

解决步骤 #

1. 确保aks-preview扩展为最新版本 #

旧版本扩展可能存在参数逻辑或兼容性问题，先更新：

# 更新aks-preview扩展
az extension update --name aks-preview

# 若更新无效，可先卸载重装
az extension remove --name aks-preview
az extension add --name aks-preview

2. 确认AKS子网已关联正确的UDR #

更新出口类型为userDefinedRouting的前提是，集群所在子网必须关联包含出口规则的UDR：

• 查看当前子网的路由表关联状态：

  az network vnet subnet show --resource-group rg-my-aks --vnet-name <你的VNet名称> --name <AKS子网名称> --query routeTable.id
  

  若返回null，说明未关联UDR，执行以下命令完成关联：

  az network vnet subnet update --resource-group rg-my-aks --vnet-name <你的VNet名称> --name <AKS子网名称> --route-table <你的UDR名称>
  

3. 执行AKS出口类型更新命令 #

子网关联好UDR后，直接执行更新命令即可，无需添加--vnet-subnet-id：

az aks update --resource-group rg-my-aks --name aks-my --outbound-type userDefinedRouting

验证更新结果 #

执行以下命令确认出口类型已变更：

az aks show --resource-group rg-my-aks --name aks-my --query outboundType

内容的提问来源于stack exchange，提问作者some_random_dude