部署ARM Template Spec时出现“Main Template parameter not found”错误

问题根源 #

你混淆了Template Spec本身的部署参数和内嵌mainTemplate的参数：

• 创建Template Spec的ARM模板，顶层只接受template_location、template_name、template_version三个参数——这是用来定义Template Spec这个Azure资产本身的属性。
• resource_name是属于mainTemplate的参数，只有在使用这个Template Spec部署实际资源时才需要传入，不能在创建Template Spec的阶段传递。

具体修复步骤 #

1. 修正Template Spec的ARM模板结构
   在mainTemplate的parameters块内定义resource_name，确保引用正确：

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {
       "template_name": { "type": "string" },
       "template_version": { "type": "string" },
       "template_location": { "type": "string" }
     },
     "resources": [
       {
         "type": "Microsoft.Resources/templateSpecs",
         "apiVersion": "2021-05-01",
         "name": "[parameters('template_name')]",
         "location": "[parameters('template_location')]",
         "properties": {
           "version": {
             "[parameters('template_version')]": {
               "properties": {
                 "mainTemplate": {
                   "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
                   "contentVersion": "1.0.0.0",
                   "parameters": {
                     // 在mainTemplate内部定义resource_name参数
                     "resource_name": {
                       "type": "string",
                       "metadata": { "description": "Name of the target resource" }
                     }
                   },
                   "resources": [
                     // 引用mainTemplate内部的参数
                     {
                       "type": "Microsoft.Storage/storageAccounts",
                       "apiVersion": "2023-01-01",
                       "name": "[parameters('resource_name')]",
                       "location": "[resourceGroup().location]",
                       "sku": { "name": "Standard_LRS" },
                       "kind": "StorageV2"
                     }
                   ]
                 }
               }
             }
           }
         }
       }
     ]
   }
   

2. 部署Template Spec（仅传三个必填参数）
   用Azure CLI或PowerShell部署时，只传入Template Spec自身的三个参数，例如CLI命令：

   az deployment group create \
     --resource-group <template-spec-rg> \
     --template-file ./template-spec-def.json \
     --parameters template_name=myTemplateSpec template_version=1.0 template_location=eastus
   

   这一步的目的是把Template Spec作为模板资产存到Azure中，不需要传入resource_name。

3. 使用Template Spec部署实际资源（传入mainTemplate参数）
   当需要基于这个Template Spec创建资源时，再传入resource_name参数，例如：

   az deployment group create \
     --resource-group <target-rg> \
     --template-spec /subscriptions/<sub-id>/resourceGroups/<template-spec-rg>/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0 \
     --parameters resource_name=mystorageaccount001
   

为什么之前的操作会报错 #

• 第一次报错找不到resource_name：因为你没在mainTemplate的parameters块内定义该参数，或者在mainTemplate的资源部分引用时名称写错。
• 第二次传参被拒：因为创建Template Spec的部署操作只识别顶层的三个参数，resource_name属于嵌套的mainTemplate层级，不能在这一步传递。
• 条件逻辑无效：你可能把条件加在了Template Spec的顶层资源上，而非mainTemplate内部的资源定义里，逻辑层级错误导致无效。

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