Azure Blueprints でエラーを解決する

重要

2026 年 7 月 11 日に、Blueprints (プレビュー) は非推奨になります。 既存のブループリントの定義と割り当てを Template Specsデプロイ スタックに移行します。 ブループリント アーティファクトは、デプロイ スタックの定義に使用される ARM JSON テンプレートまたは Bicep ファイルに変換されます。 アーティファクトを ARM リソースとして作成する方法については、次を参照してください。

ブループリントの作成、割り当て、または削除を行うときに、エラーが発生することがあります。 この記事では、発生する可能性があるさまざまなエラーと、その解決方法について説明します。

エラー詳細の検索

多くのエラーは、ブループリントをスコープに割り当てることから発生します。 割り当てられなかったとき、デプロイの失敗に関する詳細がブループリントにより提供されます。 この情報から問題が示されるので、問題を解決すれば、次回のデプロイは成功します。

  1. 左側のウィンドウにある [すべてのサービス] を選択します。 [ブループリント] を探して選択します。

  2. 左側のページから [割り当てられたブループリント] を選択し、検索ボックスを使用してブループリントの割り当てをフィルター処理し、失敗した割り当てを検索します。 [プロビジョニング状態] 列で割り当て表を並べ替え、失敗した割り当てをまとめて表示することもできます。

  3. 状態が [失敗] のブループリントを選択するか、 [割り当ての詳細を表示する] を右クリックして選択します。

  4. ブループリント割り当てページの一番上に、割り当ての失敗を警告する赤いバナーが表示されます。 バナーの任意の場所を選択すると、詳細が表示されます。

全体としてのブループリントではなく、成果物がエラーの原因となることがよくあります。 成果物によってキー コンテナーが作成される場合、Azure Policy によってキー コンテナーの作成が阻止され、割り当て全体が失敗します。

一般エラー

シナリオ:ポリシー違反

問題

ポリシー違反に起因してテンプレートのデプロイが失敗しました。

原因

ポリシーは以下の理由からデプロイと競合することがあります。

  • 作成されるリソースはポリシーの制約を受けます (一般的には SKU または場所の制約)
  • デプロイはポリシーによって構成される設定フィールドです (タグで一般的)

解決方法

ブルー プリントを変更して、エラーの詳細に含まれているポリシーと競合しないようにします。 変更できない場合、代替として、ブループリントがポリシーと競合しないようにポリシー割り当てのスコープを変更するという選択肢があります。

シナリオ:ブループリント パラメーターが関数である

問題

関数であるブループリント パラメーターが、成果物に渡される前に処理されます。

原因

[resourceGroup().tags.myTag] などの関数を使用するブループリント パラメーターを成果物に渡すと、動的関数ではなく、成果物に対して関数が設定されます。

解決方法

関数をパラメーターとして渡すには、ブループリント パラメーターが [[resourceGroup().tags.myTag] のようになるように、文字列全体を [ でエスケープします。 エスケープ文字により、Blueprints によってブループリントが処理されるときに値が文字列として扱われます。 その後、関数は Blueprints サービスによって成果物に配置され、意図したとおりに動的になります。 詳細については、「Azure Resource Manager テンプレートの構文と式」を参照してください。

削除エラー

シナリオ:割り当て削除のタイムアウト

問題

ブループリント割り当ての削除が完了していません。

原因

ブループリント割り当ては、削除されると、最終状態以外の状態のままになることがあります。 この状態は、ブループリント割り当てによって作成されたリソースが、まだ削除を保留しているか、Azure Blueprints に状態コードを返していない場合に発生します。

解像度

最終状態以外の状態のブループリント割り当ては、"6 時間" のタイムアウト後に失敗として自動的にマークされます。 タイムアウトによってブループリント割り当ての状態が調整されたら、削除を再試行できます。

次のステップ

問題がわからなかった場合、または問題を解決できない場合は、次のいずれかのチャネルでサポートを受けてください。

  • Azure フォーラムを通じて Azure エキスパートから回答を得ることができます。
  • @AzureSupport に問い合わせる - Microsoft Azure 公式アカウントです。Azure コミュニティを適切なリソース (回答、サポート、エキスパート) に結び付けることで、カスタマー エクスペリエンスを向上します。
  • さらにヘルプが必要であれば、Azure サポート インシデントを送信できます。 その場合は、 Azure サポートのサイト に移動して、 [サポートの要求] をクリックします。