Azure中如何基于已委派子网创建连接私有AKS的私有端点?
报错根因
这是Azure平台的硬性配置互斥规则:已被委派的子网不支持创建私有端点。子网委派的设计定位是专供需要网络注入能力的PaaS服务(如容器应用环境、App Service环境、SQL托管实例等)使用,无法同时承载私有端点这类网络资源。
可行处理方案
方案1:新建专用非委派子网承载私有端点(推荐)
适用于当前被委派子网已经部署了实际PaaS业务负载、无法移除委派配置的场景:
- 先执行命令确认目标子网的委派详情,明确委派绑定的服务类型:
az network vnet subnet show --name eastus2-28828-nprd-snet --vnet-name eastus-28828-nprd-vnet --resource-group hat-eastus2-nprd-rg --query delegations - 在当前VNET的地址空间范围内,选取未被占用的CIDR段,新建无委派属性的子网作为私有端点专用网段,创建时需同步禁用私有端点网络策略(这是私有端点部署的强制要求):
az network vnet subnet create \ --name dedicated-pe-snet \ --vnet-name eastus-28828-nprd-vnet \ --resource-group hat-eastus2-nprd-rg \ --address-prefixes 替换为VNET内未占用的CIDR网段 \ --private-endpoint-network-policies Disabled
- 修改原有私有端点创建命令中的
--subnet参数值为新建的专用子网名,重新执行创建命令即可。
方案2:移除原有子网的委派配置后直接部署
适用于当前被委派子网无实际承载业务、不需要保留委派属性的场景:
- 清除该子网下的所有委派配置:
az network vnet subnet update \ --name eastus2-28828-nprd-snet \ --vnet-name eastus-28828-nprd-vnet \ --resource-group hat-eastus2-nprd-rg \ --remove delegations
- 为该子网禁用私有端点网络策略:
az network vnet subnet update \ --name eastus2-28828-nprd-snet \ --vnet-name eastus-28828-nprd-vnet \ --resource-group hat-eastus2-nprd-rg \ --private-endpoint-network-policies Disabled
- 重新执行原私有端点创建命令即可。
关键注意事项
- 如果被委派子网已经部署了依赖该委派配置运行的PaaS服务,禁止直接移除委派,否则会直接导致对应服务的网络连通性中断。
- 私有端点所在子网的
private-endpoint-network-policies必须设置为Disabled,否则即使子网无委派配置,也会触发创建报错。 - 你当前命令中针对私有AKS的参数配置(
--group-ids management、AKS资源ID)均为正确配置,不需要调整。
内容的提问来源于stack exchange,提问作者msuzuki
相关产品推荐
相关产品推荐

