使用Bicep部署Service Bus Private Endpoint失败，是否需添加子网？

核心结论：创建Private Endpoint必须关联子网 #

是的，Azure Private Endpoint的创建必须指定虚拟网络中的子网，这是私有端点资源的必填配置项。私有端点需要部署在子网内，该子网可以是专用子网，也可与其他资源共享，但需确保子网未启用阻止私有端点的网络策略（默认允许）。

你的代码存在的问题 #

当前代码仅定义了Service Bus命名空间的privateEndpointConnections资源（用于关联已有私有端点），但未实际创建Microsoft.Network/privateEndpoints资源（真正的私有端点实例），同时存在语法错误：

• PrivateEndpointId : 属于无效语法，param参数定义格式错误
• 手动设置provisioningState属性无效，该属性由Azure系统自动维护，无需手动指定

修正后的完整Bicep示例 #

以下是包含私有端点（关联子网）创建及Service Bus连接配置的完整代码：

param serviceBusNamespaceName string
param privateEndpointName string
param subscriptionId string
param resourceGroupName string
param vnetResourceId string // 目标虚拟网络资源ID
param subnetName string // 要关联的子网名称

// 1. 创建Private Endpoint资源（必须关联子网）
resource privateEndpoint 'Microsoft.Network/privateEndpoints@2023-09-01' = {
  name: privateEndpointName
  location: resourceGroup().location
  properties: {
    subnet: {
      id: '${vnetResourceId}/subnets/${subnetName}'
    }
    privateLinkServiceConnections: [
      {
        name: privateEndpointName
        properties: {
          privateLinkServiceId: resourceId('Microsoft.ServiceBus/namespaces', serviceBusNamespaceName)
          groupIds: ['namespace'] // Service Bus私有链接组ID固定为'namespace'
          requestMessage: 'Auto-approved connection for Service Bus'
        }
      }
    ]
  }
}

// 2. 创建Service Bus的私有端点连接（自动批准）
resource privateEndpointConnection 'Microsoft.ServiceBus/namespaces/privateEndpointConnections@2022-10-01-preview' = {
  parent: resourceId('Microsoft.ServiceBus/namespaces', serviceBusNamespaceName)
  name: privateEndpoint.name
  properties: {
    privateEndpoint: {
      id: privateEndpoint.id
    }
    privateLinkServiceConnectionState: {
      status: 'Approved'
      description: 'Auto-approved'
    }
  }
}

关键说明 #

• 私有端点的subnet.id为必填项，必须指向虚拟网络中的子网资源
• Service Bus的私有链接组ID固定为namespace，不可修改
• 无需手动设置provisioningState，Azure会自动更新该状态

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