次の方法で共有


エラー コードを見つける

Azure Resource Manager テンプレート (ARM テンプレート) または Bicep ファイルを使用して Azure リソースのデプロイが失敗すると、エラー コードを受け取ります。 この記事では、問題をトラブルシューティングするためにエラー コードを見つける方法について説明します。 エラー コードの詳細については、一般的なデプロイ エラーに関する記事を参照してください。

エラーの種類

デプロイに関するエラーには 3 種類あります。

  • 検証エラー デプロイ開始前に、ファイル中の構文エラーによって発生します。 これらのエラーは、Visual Studio Code などのコード エディターで特定できます。
  • プレフライト検証エラーは、デプロイ コマンドが実行されてもリソースがデプロイされない場合に発生します。 これらのエラーは、デプロイを開始しなくても検出されます。 たとえば、パラメーターの値が正しくない場合は、プレフライト検証でエラーが検出されます。
  • デプロイ エラー Azure 環境におけるデプロイのプロセスで発生し、デプロイの進行状況を確認することでのみ検出できます。

どの種類のエラーでも、デプロイのトラブルシューティングに使用できるエラー コードが出力されます。 検証とプレフライトのエラーはアクティビティ ログに表示されますが、デプロイ履歴には表示されません。 構文エラーがある Bicep ファイルは JSON にコンパイルされず、アクティビティ ログに表示されません。

構文エラーを識別するには、Visual Studio Code と最新の Bicep 拡張機能または Azure Resource Manager ツールの拡張機能を使用できます。

検証エラー

テンプレートはデプロイ プロセス中に検証され、エラー コードが表示されます。 デプロイを実行する前に、Azure PowerShell または Azure CLI を使用して検証テストを実行することで、検証とプレフライト エラーを識別できます。

ARM テンプレートは、ポータルからデプロイできます。 テンプレートに構文エラーがある場合は、デプロイを実行しようとすると検証エラーが表示されます。 ポータル デプロイの詳細については、「カスタム テンプレートからリソースをデプロイする」を参照してください。

次の例では、ストレージ アカウントのデプロイを試み、検証エラーが発生します。

Azure portal でのストレージ アカウントのデプロイ試行の検証エラーのスクリーンショット。

詳細については、メッセージを選択します。 テンプレートには、エラー コード InvalidTemplate を含む構文エラーがあります。 [概要] は、式に閉じかっこが不足していることを示しています。

エラー コード InvalidTemplate の構文エラーを示す、Azure portal の検証エラー メッセージのスクリーンショット。

展開エラー

Azure リソースをデプロイするために、いくつかの操作が処理されます。 操作が検証に合格してもデプロイ中に失敗すると、デプロイ エラーが発生します。 各デプロイ操作とリソース グループの各デプロイに関するメッセージを表示できます。

デプロイの操作に関するメッセージを表示するには、リソース グループのアクティビティ ログを使用します。

  1. Azure ポータルにサインインします。

  2. [リソース グループ] に移動し、デプロイのリソース グループ名を選択します。

  3. [アクティビティ ログ] を選択します。

  4. フィルターを使用して、操作のエラー ログを検索します。

    Azure portal のリソース グループ アクティビティ ログのスクリーンショット。エラー ログで失敗したデプロイを強調しています。

  5. エラー ログを選択すると、操作の詳細が表示されます。

    失敗したデプロイのエラー メッセージと操作の詳細を示す、Azure portal のアクティビティ ログの詳細のスクリーンショット。

デプロイの結果を表示するには、次のようにします。

  1. リソース グループに移動します。

  2. [設定]>[デプロイ] を選択します。

  3. デプロイの [エラーの詳細] を選択します。

    失敗したデプロイのエラー詳細へのリンクが表示されている、Azure portal のリソース グループのデプロイ セクションのスクリーンショット。

  4. エラー メッセージとエラー コード NoRegisteredProviderFound が表示されます。

    エラー メッセージとエラー コード NoRegisteredProviderFound を示す、Azure portal のデプロイ エラーの概要のスクリーンショット。

次の手順