如何在Bicep中定义子网 满足VNet引用与dependsOn依赖要求

你遇到的循环依赖、无法生成子网引用的问题，是混用了两种子网定义方式导致的，直接按下面的写法即可同时满足部署规则和依赖引用要求：

核心规则 #

使用独立子资源方式定义子网时，不需要在父虚拟网络的properties.subnets数组中重复声明子网配置。
网上流传的「必须在vnet的subnets字段定义子网否则触发InUseSubnetCannotBeDeleted报错」是早期ARM模板的遗留限制，当前版本Bicep（v0.4及以上）处理Microsoft.Network/virtualNetworks/subnets类型子资源时，会自动维护子网与父vnet的关联关系，不会触发该类删除报错。

可直接复用的代码示例 #

// 定义虚拟网络，subnets数组留空即可
resource virtualNetwork 'Microsoft.Network/virtualNetworks@2021-08-01' = {
  name: 'vnet-prod-001'
  location: resourceGroup().location
  properties: {
    addressSpace: {
      addressPrefixes: [
        '10.10.0.0/16'
      ]
    }
    // 无需在此处填充subnets配置
  }
}

// 独立声明每个子网，通过parent属性关联父vnet
resource subnet1 'Microsoft.Network/virtualNetworks/subnets@2021-08-01' = {
  parent: virtualNetwork
  name: 'subnet-app'
  properties: {
    addressPrefix: '10.10.1.0/24'
    // 其余子网配置（网络安全组、路由表、服务端点等）正常写在此处
  }
}

resource subnet2 'Microsoft.Network/virtualNetworks/subnets@2021-08-01' = {
  parent: virtualNetwork
  name: 'subnet-db'
  properties: {
    addressPrefix: '10.10.2.0/24'
  }
}

方案优势 #

• 每个子网都是独立的资源对象，可直接在其他资源的dependsOn数组中引用subnet1、subnet2，也可直接通过.id、.name等属性获取子网配置参数
• 无循环依赖问题，Bicep会自动计算部署顺序：先完成虚拟网络部署，再逐个部署关联子网
• 部署过程不会触发子网意外删除的报错，Bicep编译生成的ARM模板会自动处理vnet与子网的关联更新逻辑

注意事项 #

• 禁止将同个子网同时写在vnet的内联subnets数组、又声明为独立子资源，会触发重复定义错误
• 禁止在vnet的properties.subnets数组中直接引用独立声明的子网对象，会触发循环依赖校验报错
• 如果使用Bicep版本低于v0.4，先升级Bicep CLI即可，不需要手动写ARM模板时代的文本引用绕开校验

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