使用Azure DevOps部署ADF（链接/嵌套模板）时遇InvalidContentLink错误如何修复

1. 修正嵌套模板的内容链接格式 #

• 所有嵌套模板的contentLink必须使用绝对URI，禁止使用本地路径、UNC路径或相对路径。正确做法是将嵌套模板上传至Azure存储容器（需配置匿名读取权限或生成SAS令牌），链接格式示例：

  "contentLink": {
    "uri": "https://yourstorageaccount.blob.core.windows.net/templates/adf-nested-template.json?sv=2022-11-02&ss=b&srt=sco&sp=r&se=2024-12-31T23:59:59Z&st=2024-01-01T00:00:00Z&spr=https&sig=xxxxxx",
    "contentVersion": "1.0.0.0"
  }
  

• 排查主模板中所有引用嵌套模板的节点，确保没有遗留本地路径（如./nested-template.json），ARM无法解析这类路径。

2. 调整Azure DevOps部署任务配置 #

• 在ARM模板部署任务中，不要选择“本地文件”模式部署包含嵌套模板的ADF模板，需确保所有嵌套模板已上传至ARM可访问的位置（如Azure存储、DevOps工件库）。
• 若使用ADF自带的CI/CD流水线，检查Publish ADF任务生成的ARM模板，确认嵌套模板的链接已正确指向DevOps工件库的绝对路径，避免生成无效的本地引用。

3. 排查并修复ARM模板验证错误 #

• 先通过本地工具提前验证模板，快速定位问题：
  • Azure CLI命令：az deployment group validate --resource-group <你的资源组名> --template-file main-template.json --parameters @params.json
  • PowerShell命令：Test-AzResourceGroupDeployment -ResourceGroupName <你的资源组名> -TemplateFile main-template.json -TemplateParameterFile params.json
• 检查模板语法：包括引号匹配、逗号遗漏、资源类型拼写（ADF资源类型为Microsoft.DataFactory/factories）等基础错误。
• 确认参数传递：嵌套模板中引用的参数需在主模板中定义，或通过parameters节点正确传递，避免出现未定义参数的情况。

4. 确保SAS令牌的有效性 #

• 若使用Azure存储SAS令牌访问嵌套模板，需确保令牌具备读取权限（sp=r），且有效期覆盖整个部署周期，防止部署过程中令牌过期导致链接失效。

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