ARM模板部署遇InvalidContentLink错误：无法下载部署内容

针对ARM部署子模板无法下载的InvalidContentLink错误，以下是针对性的排查和解决方法：

1. 检查SAS令牌的格式（必须带?前缀） #

用az storage container generate-sas生成的SAS令牌默认不包含开头的?，但拼接URI时需要这个前缀来区分路径和查询参数。如果缺少，SAS会被当成Blob路径的一部分，导致无法识别。

解决方法： #

• 要么在生成SAS时添加前缀：

  $SasToken = "?$($SasToken.Trim())"
  

• 要么在ARM模板拼接URI时补充：

  "uri": "[concat(parameters('LinkedTemplatesBaseUrl'), parameters('DataBricks'), '/', parameters('DataBricks'), '_Deployment_Template.json'), '?', parameters('sasToken')]"
  

2. 验证SAS令牌的权限、有效期和存储网络规则 #

• 权限与有效期：确认生成SAS时指定了--permissions r（只读权限足够下载模板），同时延长有效期测试（比如从30分钟改成1小时，避免部署排队导致令牌过期）。
• 存储网络规则：如果存储账户设置了允许特定网络访问，需要添加AzureResourceManager服务标签到例外列表，否则ARM部署服务无法访问存储账户。临时切换到允许所有网络可以快速验证是否是网络问题。

3. 检查LinkedTemplatesBaseUrl的结尾是否带/ #

如果LinkedTemplatesBaseUrl的值是https://mystoragaccount.blob.core.windows.net/arm（不带结尾的/），拼接后会变成https://mystoragaccount.blob.core.windows.net/armDatabricks/...，路径完全错误。

解决方法： #

• 确保LinkedTemplatesBaseUrl的结尾带/，比如设置为https://mystoragaccount.blob.core.windows.net/arm/
• 或者在ARM模板拼接时手动添加/：

  "uri": "[concat(parameters('LinkedTemplatesBaseUrl'), '/', parameters('DataBricks'), '/', parameters('DataBricks'), '_Deployment_Template.json', parameters('sasToken'))]"
  

4. 验证Azure DevOps变量传递的正确性 #

• 确保GenerateSasToken任务是部署任务的前置任务（同阶段无需额外配置，跨阶段需通过dependencies引用）。
• 添加调试步骤打印关键变量，确认值正确（注意不要泄露完整SAS令牌）：

  - script: |
      echo "LinkedTemplatesBaseUrl: $(blob.StorageContainerUri)"
      echo "SAS Token is not empty: $( [ -n "$(GenerateSasToken.SasToken)" ] && echo "Yes" || echo "No" )"
      echo "Expected URI prefix: $(blob.StorageContainerUri)/Databricks/Databricks_Deployment_Template.json"
    displayName: 'Debug URI Components'
  

5. 确认Blob路径的正确性 #

• 检查子模板文件是否存在于指定路径，Blob存储的路径区分大小写，确保DataBricks等参数的大小写与实际Blob路径一致。
• 直接在浏览器中拼接完整URI（包含正确的SAS令牌），测试是否能下载模板文件，排除ARM服务之外的访问问题。

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