你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

什么是部署故障排除？

  • 项目

使用 Bicep 文件或 Azure 资源管理器模板（ARM 模板）来部署 Azure 资源时，可能会出现错误。 可以借助故障排除工具在部署之前解决语法错误。 可以从 Azure 门户、Azure PowerShell 和 Azure CLI 获取有关错误代码和部署错误的详细信息。 本文档有助于查找用于排查错误的解决方案。

错误类型

验证错误发生在部署开始之前，由可以通过代码编辑器（如 Visual Studio Code）识别的错误语法引发。 例如，属性名称拼写错误，或者函数缺少参数。

在 Azure 中运行部署命令但未部署资源时，会发生预检验证错误。 例如，如果使用了不正确的参数值，部署命令会返回错误消息。

部署错误只能通过尝试进行部署并与 Azure 环境交互来确定。 例如，虚拟机 (VM) 需要一个网络接口卡 (NIC)。 如果在部署 VM 时该 NIC 不存在，则会出现部署错误。

故障排除工具

有多种故障排除工具可用于解决错误。

语法错误

若要在部署之前识别语法错误，请使用最新版 Visual Studio Code。 安装适用于 Bicep 或 ARM 模板的最新版本的扩展。

若要遵循开发部署模板的最佳做法，请使用以下工具：

资源提供程序和 API 版本

若要对部署进行故障排除，则需了解资源提供程序的属性或 API 版本。 有关详细信息，请参阅使用 Bicep 和 ARM 模板来定义资源。

错误详细信息

部署时，可以通过 Azure 门户在资源组的“部署”或“活动日志”中查找错误原因。 如果使用的是 Azure PowerShell，请使用 Get-AzResourceGroupDeploymentOperation 和 Get-AzActivityLog 之类的命令。 对于 Azure CLI，请使用 az deployment operation group 和 az monitor activity-log list 之类的命令。

后续步骤