共用方式為


針對使用 Azure 藍圖發生的錯誤進行疑難排解

重要

在 2026 年 7 月 11 日,藍圖 (預覽) 將會淘汰。 將現有的藍圖定義和指派移轉至範本規格部署堆疊。 藍圖成品會轉換成用來定義部署堆疊的 ARM JSON 範本或 Bicep 檔案。 若要了解如何將成品撰寫為 ARM 資源,請參閱:

您可能會在建立、指派或移除藍圖時遇到錯誤。 此文章說明可能發生的各種錯誤與解決方式。

尋找錯誤詳細資料

許多錯誤都是將藍圖指派給某個範圍而產生的結果。 當指派失敗時,藍圖會提供有關失敗部署的詳細資料。 此資訊會指出問題,以便能夠進行修正,而使下一次部署能成功。

  1. 在左側窗格中選取 [所有服務]。 搜尋並選取 [藍圖]

  2. 從頁面左邊選取 [指派的藍圖],然後使用搜尋方塊來篩選藍圖指派,即可尋找失敗的指派項目。 您也可以依 [佈建狀態] 欄排序指派表格,以查看所有已群組在一起的失敗指派。

  3. 選取具有 [失敗] 狀態的藍圖,或以滑鼠右鍵按一下並選取 [檢視指派詳細資料]

  4. 代表指派失敗的紅色橫幅警告位於藍圖指派頁面的最上方。 選取該橫幅上的任一處,以取得更多詳細資料。

錯誤通常是由成品 (而非整個藍圖) 造成的。 如果成品建立金鑰保存庫,而且 Azure 原則防止建立金鑰保存庫,則整個指派會失敗。

一般錯誤

案例:違反原則

問題

範本部署因為原則違規而失敗。

原因

原則可能會因下列因素而與部署產生衝突:

  • 要建立的資源受到原則所限制 (通常是 SKU 或位置限制)
  • 部署正在設定原則所設定的欄位 (通常會使用標記)

解決方法

變更藍圖,使其不會與錯誤詳細資料中的原則發生發生衝突。 如果此變更不可行,替代選項就是變更原則指派的範圍,使藍圖不再與原則產生衝突。

案例:藍圖參數是函式

問題

為函式的藍圖參數會先經過處理,再傳遞至成品。

原因

將使用如 [resourceGroup().tags.myTag] 等函式的藍圖參數傳遞至成品,會造成在成品上設定該函式處理過後的結果,而非動態函式。

解決方法

若要將函式作為參數傳遞,請使用 [ 逸出整個字串,讓藍圖參數看起來像 [[resourceGroup().tags.myTag]。 逸出字元會導致「藍圖」在處理藍圖時,將值視為字串。 接著,藍圖服務會將函式置於成品上,使之依預期成為動態函式。 如需詳細資訊,請參閱 Azure Resource Manager 範本中的語法和運算式

刪除錯誤

案例:指派刪除逾時

問題

藍圖指派的刪除作業未完成。

原因

刪除時,藍圖指派可能會停滯在非終端機狀態。 當藍圖指派所建立的資源仍在等待刪除,或未將狀態碼傳回 Azure 藍圖時,就會造成此狀態。

解決方法

非終端機狀態的藍圖指派會在六小時逾時後自動標記為 [失敗]。 藍圖指派的狀態經逾時調整後,就可以重試刪除。

下一步

如果您沒有看到您的問題,或無法解決您的問題,請瀏覽下列其中一個管道以取得更多支援:

  • 透過 Azure 論壇獲得由 Azure 專家所提供的解答。
  • @AzureSupport 連繫 - 此是專為改善客戶體驗而設的官方 Microsoft Azure 帳戶,協助 Azure 社群連接至適當的資源,像是解答、支援及專家等。
  • 如果需要更多協助,您可以提出 Azure 支援事件。 請移至 Azure 支援網站,然後選取 [取得支援]