Bicep ファイルまたは Azure Resource Manager テンプレート (ARM テンプレート) を使用して Azure リソースをデプロイすると、エラーが発生する場合があります。 デプロイ前に構文エラーを解決するのに役立つトラブルシューティング ツールがあります。 エラー コードとデプロイ エラーの詳細については、Azure portal、Azure PowerShell、Azure CLI から取得できます。 このドキュメントは、エラーのトラブルシューティングの解決策を見つけるのに役立ちます。
エラーの種類
検証エラーは、デプロイが開始される前に発生し、Visual Studio Code などのコード エディターで識別できる構文が正しくないことが原因で発生します。 たとえば、プロパティ名のスペルが間違っている、または引数がない関数などです。
プレフライト検証エラーは、デプロイ コマンドが実行されても、リソースが Azure にデプロイされていない場合に発生します。 たとえば、正しくないパラメータ値を使用すると、デプロイメント・コマンドはエラー・メッセージを返します。
デプロイ エラーは、デプロイを試行し、Azure 環境と対話することによってのみ判断できます。 たとえば、仮想マシン (VM) にはネットワーク インターフェイス カード (NIC) が必要です。 VM のデプロイ時に NIC が存在しない場合は、デプロイ エラーが発生します。
トラブルシューティング ツール
エラーを解決するために使用できるトラブルシューティングツールがいくつかあります。
構文エラー
デプロイ前に構文エラーを特定するには、最新バージョンの Visual Studio Code を使用します。 Bicep または ARM テンプレートの拡張機能の最新バージョンをインストールします。
デプロイメントテンプレートの開発に関するベストプラクティスに従うには、次のツールを使用します。
リソース プロバイダーと API のバージョン
デプロイのトラブルシューティングを行うには、リソース プロバイダーのプロパティまたは API バージョンについて学習すると役立ちます。 詳細については、「 Bicep テンプレートと ARM テンプレートを使用してリソースを定義する」を参照してください。
エラーの詳細
デプロイすると、Azure portal のリソース グループの デプロイログまたはアクティビティ ログでエラーの原因を見つけることができます。 Azure PowerShell を使用している場合は、 Get-AzResourceGroupDeploymentOperation や Get-AzActivityLog などのコマンドを使用します。 Azure CLI の場合は、 az deployment operation group や az monitor activity-log list などのコマンドを使用します。
次のステップ
- デプロイメントのエラーコードを見つける方法と、デプロイメントの問題のトラブルシューティングを行う方法の詳細については、「 エラーコードを見つける」を参照してください。
- エラー コードに基づく解決策については、「 一般的な Azure デプロイ エラーのトラブルシューティング」を参照してください。
- エラー コードを見つける方法の概要については、「 クイック スタート: ARM テンプレート JSON デプロイのトラブルシューティング 」または「 クイック スタート: Bicep ファイルのデプロイのトラブルシューティング」を参照してください。