能否在Azure Template Spec的uiFormDefinition中使用引用函数与ArmApiControl？

核心问题根源 #

Template Spec使用的是uiFormDefinition schema（2021-09-09版本），和旧版CreateUIDefinition的语法、控件规则不兼容。你遇到的错误本质是混用了两种schema的表达式语法和控件配置方式。

具体解决步骤 #

1. 改用ARM表达式语法包裹动态引用
   旧版CreateUIDefinition中直接调用的location()、订阅ID这类函数，在uiFormDefinition里必须用ARM表达式格式（用方括号[]包裹）：

   • 获取当前位置：[location()]
   • 获取订阅ID：[subscription().subscriptionId]

2. 调整ArmApiControl的path配置
   所有动态路径片段都要用ARM表达式函数拼接，不能直接用字符串连接。举个获取SQL实例能力的配置示例：

   {
     "name": "sqlCapabilities",
     "type": "Microsoft.Solutions.ArmApiControl",
     "properties": {
       "path": "[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Sql/locations/', location(), '/capabilities')]",
       "method": "GET"
     }
   }
   

3. 确保schema合规
   你的uiFormDefinition文件顶部必须指定正确的schema：

   "$schema": "https://schema.management.azure.com/schemas/2021-09-09/uiFormDefinition.schema.json"
   

   禁止使用旧版CreateUIDefinition的schema，否则会触发Invalid UIFormDefinition Schema错误。

4. 在对应沙箱中测试
   必须使用Form view Sandbox进行测试，因为它对应uiFormDefinition的schema规则。把调整后的配置粘贴进去，就能正常加载ArmApiControl并验证动态路径的有效性。

常见错误排查 #

• 若仍出现Failed to create element of type: 'Microsoft.Solutions.ArmApiControl'：检查path中的ARM表达式是否正确，比如函数拼写、括号配对，确保所有动态值都在[]包裹的表达式内。
• 若出现schema错误：检查文件顶部的schema地址是否正确，同时确保整个UI定义的结构符合uiFormDefinition的要求（比如顶级节点是schema、content、outputs等）。

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