Azure Blueprints でエラーを解決する
重要
2026 年 7 月 11 日に、Blueprints (プレビュー) は非推奨になります。 既存のブループリントの定義と割り当てを Template Specs とデプロイ スタックに移行します。 ブループリント アーティファクトは、デプロイ スタックの定義に使用される ARM JSON テンプレートまたは Bicep ファイルに変換されます。 アーティファクトを ARM リソースとして作成する方法については、次を参照してください。
ブループリントの作成、割り当て、または削除を行うときに、エラーが発生することがあります。 この記事では、発生する可能性があるさまざまなエラーと、その解決方法について説明します。
エラー詳細の検索
多くのエラーは、ブループリントをスコープに割り当てることから発生します。 割り当てられなかったとき、デプロイの失敗に関する詳細がブループリントにより提供されます。 この情報から問題が示されるので、問題を解決すれば、次回のデプロイは成功します。
左側のウィンドウにある [すべてのサービス] を選択します。 [ブループリント] を探して選択します。
左側のページから [割り当てられたブループリント] を選択し、検索ボックスを使用してブループリントの割り当てをフィルター処理し、失敗した割り当てを検索します。 [プロビジョニング状態] 列で割り当て表を並べ替え、失敗した割り当てをまとめて表示することもできます。
状態が [失敗] のブループリントを選択するか、 [割り当ての詳細を表示する] を右クリックして選択します。
ブループリント割り当てページの一番上に、割り当ての失敗を警告する赤いバナーが表示されます。 バナーの任意の場所を選択すると、詳細が表示されます。
全体としてのブループリントではなく、成果物がエラーの原因となることがよくあります。 成果物によってキー コンテナーが作成される場合、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 サポートのサイト に移動して、 [サポートの要求] をクリックします。