ARM模板输出private-endpoint私有IP地址报错如何解决

原表达式报错是因为取值路径不符合私有端点资源的返回结构：

• 私有端点实例返回的networkInterfaces字段是数组类型，必须指定数组索引才能访问子属性，直接链式调用属性会触发无效数组索引错误
• privateIPAddress字段并不直接挂载在networkInterfaces对象下，而是嵌套在网卡的IP配置子属性中

单IP场景（绝大多数常规部署场景） #

常规私有端点部署只会关联1块网卡、分配1个私有IP，直接取数组首元素即可，输出值为字符串类型的私有IP：

"privateEndpointIp": {
  "type": "string",
  "value": "[reference(resourceId('Microsoft.Network/privateEndpoints', parameters('privateEndpointName'))).networkInterfaces[0].properties.ipConfigurations[0].properties.privateIPAddress]"
}

多IP场景 #

如果给私有端点配置了多个私有IP，用如下表达式输出所有IP组成的数组：

"privateEndpointIps": {
  "type": "array",
  "value": "[map(reference(resourceId('Microsoft.Network/privateEndpoints', parameters('privateEndpointName'))).networkInterfaces[0].properties.ipConfigurations, ipConfig => ipConfig.properties.privateIPAddress)]"
}

兼容特殊场景的稳定写法 #

如果遇到属性缺失的返回错误，可以给reference函数指定稳定API版本并要求返回全量属性，避免不同API版本结构差异导致的取值失败：

"value": "[reference(resourceId('Microsoft.Network/privateEndpoints', parameters('privateEndpointName')), '2023-09-01', 'Full').networkInterfaces[0].properties.ipConfigurations[0].properties.privateIPAddress]"

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