Azure Data Factory CI/CD链接ARM模板部署InvalidTemplate错误求助

错误原因 #

这个错误是因为链接ARM模板中定义的Data Factory子资源（比如pipeline）的资源名称格式不符合ARM模板规则：
当资源类型是Microsoft.DataFactory/factories/pipelines（根级别资源，未嵌套在factory资源下）时，资源名称必须包含两段（工厂名/资源名），但你的模板里写的是/pipeline1（仅一段），导致类型的段数（2段）和名称的段数（1段）不匹配，触发验证失败。

解决步骤 #

1. 修正链接模板中的资源名称格式 #

打开对应子资源的链接ARM文件，按以下两种场景调整：

• 根级别定义子资源（不嵌套在factory资源内）：资源名称必须拼接工厂名，示例：

{
  "type": "Microsoft.DataFactory/factories/pipelines",
  "apiVersion": "2018-06-01",
  "name": "[concat(parameters('factoryName'), '/pipeline1')]",
  "properties": {
    // 你的pipeline配置内容
  }
}

• 嵌套在factory资源下定义：资源类型简化为pipelines，名称仅用资源名，示例：

{
  "type": "Microsoft.DataFactory/factories",
  "apiVersion": "2018-06-01",
  "name": "[parameters('factoryName')]",
  "location": "[parameters('location')]",
  "resources": [
    {
      "type": "pipelines",
      "name": "pipeline1",
      "apiVersion": "2018-06-01",
      "dependsOn": [
        "[resourceId('Microsoft.DataFactory/factories', parameters('factoryName'))]"
      ],
      "properties": {
        // 你的pipeline配置内容
      }
    }
  ]
}

2. 确认链接模板的参数传递 #

检查主模板（ArmTemplate_master.json）引用链接模板时，是否正确传递factoryName参数，示例引用片段：

{
  "resources": [
    {
      "type": "Microsoft.Resources/deployments",
      "apiVersion": "2021-04-01",
      "name": "pipelineDeployment",
      "properties": {
        "mode": "Incremental",
        "templateLink": {
          "uri": "[concat(parameters('containerUri'), '/pipelineTemplate.json', parameters('containerSasToken'))]"
        },
        "parameters": {
          "factoryName": { "value": "[parameters('factoryName')]" }
        }
      }
    }
  ]
}

3. 验证YAML脚本的参数正确性 #

在YAML脚本中添加echo "factoryName: $adfName"，确认$adfName是否正确获取到目标Data Factory的名称，避免空值或拼写错误。

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