針對常見 Azure 部署錯誤進行疑難排解

本文說明常見的 Azure 部署錯誤,並且提供解決方案的資訊。 Azure 資源可以使用 Azure Resource Manager 範本 (ARM 範本) 或 Bicep 檔案進行部署。 如果您找不到部署錯誤的錯誤碼,請參閱尋找錯誤碼

如果未列出您的錯誤碼,請提交 GitHub 問題。 在頁面右側,選取 [意見反應]。 在頁面底部的 [意見反應] 底下,選取 [此頁面]。 提供您的文件意見反應,但請勿包含機密資訊,因為 GitHub 問題是公開的。

錯誤碼

錯誤碼 降低 詳細資訊
AccountNameInvalid 遵循儲存體帳戶的命名限制。 解析儲存體帳戶名稱
AccountPropertyCannotBeSet 檢查可用儲存體帳戶屬性。 storageAccounts
AllocationFailed 叢集或區域沒有可用的資源或無法支援所要求的 VM 大小。 稍後重試要求,或要求不同的 VM 大小。 Linux 佈建和配置問題

Windows 佈建和配置問題

為配置失敗進行疑難排解
AnotherOperationInProgress 等候並行作業完成。
AuthorizationFailed 您的帳戶或服務主體沒有完成部署的足夠存取權。 請檢查您的帳戶所屬的角色以及它針對部署範圍的存取權。

當所需的資源提供者未註冊時,您可能會收到此錯誤。
Azure 角色型存取控制 (Azure RBAC)

解析註冊
BadRequest 您傳送的部署值不符合資源管理員的預期。 請查看內部狀態訊息,以取得疑難排解的說明。 範本參考

ARM 範本中的資源位置

Bicep 檔案中的資源位置
衝突 您要求的作業在資源的目前狀態下不允許。 例如,只有在建立 VM 時或解除配置 VM 之後,才可調整磁碟大小。
DeploymentActiveAndUneditable 等候此資源群組的並行部署完成。
DeploymentFailedCleanUp 當您以完整模式部署時,會刪除不在範本中的任何資源。 當您沒有足夠權限可以刪除不在範本中的所有資源時,就會收到這個錯誤。 若要避免這個錯誤,請將部署模式變更為累加。 Azure Resource Manager 部署模式
DeploymentNameInvalidCharacters 部署名稱只能包含字母、數字、連字號 (-)、點 (.) 或底線 (_)
DeploymentNameLengthLimitExceeded 部署名稱限制為 64 個字元。
DeploymentFailed DeploymentFailed 錯誤是一般錯誤,不會提供您解決錯誤所需的詳細資料。 尋找錯誤碼的錯誤詳細資料,以提供更多資訊。 尋找錯誤碼
DeploymentQuotaExceeded 如果每個資源群組的部署達到 800 個數量限制,請從歷程記錄中刪除不再需要的部署。 解決部署計數超過 800 個的錯誤
DeploymentJobSizeExceeded 簡化您的範本以縮減大小。 解決範本大小錯誤
DnsRecordInUse DNS 記錄名稱必須是唯一的。 輸入其他名稱。
ImageNotFound 檢查 VM 映像設定。
InaccessibleImage Azure 容器執行個體部署失敗。 您可能需要使用語法 registry/image:tag 來包含映像的標籤,才能部署容器。 針對私人登錄,請確認您的認證正確無誤。 尋找錯誤碼
InternalServerError 暫時性問題所導致。 重試部署。
InUseSubnetCannotBeDeleted 當您嘗試更新資源時,如果要求程序刪除然後建立資源,就會發生此錯誤。 請務必指定所有不變的值。 更新資源
InvalidAuthenticationTokenTenant 取得適當租用戶的存取權杖。 您只能從您的帳戶所屬的租用戶取得權杖。
InvalidContentLink 您最有可能嘗試連結至無法使用的巢狀範本。 再次確認您為巢狀範本提供的 URI。 如果儲存體帳戶中已有範本,請確定 URI 可存取。 您可能需要傳送 SAS 權杖。 您目前無法連結到位於 Azure 儲存體防火牆後儲存體帳戶中的範本。 請考慮將您的範本移至另一個存放庫,例如 GitHub。 連結和巢狀的 ARM 範本

Bicep 模組
InvalidDeploymentLocation 在訂用帳戶層級進行部署時,您為先前使用的部署名稱提供不同的位置。 ARM 範本訂用帳戶部署

Bicep 訂用帳戶部署
InvalidParameter 您為資源提供的其中一個值與預期值不相符。 此錯誤的原因可能是許多不同情況。 例如,密碼強度不足,或 blob 名稱不正確。 錯誤訊息應該會指出需要更正的值。 ARM 範本參數

Bicep 參數
InvalidRequestContent 部署值包含未辨識的值,或遺漏必要值。 請確認您的資源類型值。 範本參考
InvalidRequestFormat 執行部署時啟用偵錯記錄,並且確認要求的內容。 偵錯記錄
InvalidResourceLocation 提供儲存體帳戶的唯一名稱。 解析儲存體帳戶名稱
InvalidResourceNamespace 請檢查您在 type 屬性中指定的資源命名空間。 範本參考
InvalidResourceReference 資源不存在或未正確地參考。 檢查是否需要新增相依性。 確認您使用 reference 函式包括案例的必要參數。 解析相依性
InvalidResourceType 請檢查您在 type 屬性中指定的資源類型。 範本參考
InvalidSubscriptionRegistrationState 向資源提供者註冊訂用帳戶。 解析註冊
InvalidTemplateDeployment
InvalidTemplate
請檢查錯誤的範本語法。 解析無效的範本
InvalidTemplateCircularDependency 移除不必要的相依性。 解析循環相依性
JobSizeExceeded 簡化您的範本以縮減大小。 解決範本大小錯誤
LinkedAuthorizationFailed 檢查您的帳戶是否屬於與部署所在資源群組相同的租用戶。
LinkedInvalidPropertyId 資源的資源識別碼未解析。 檢查您是否已提供資源識別碼的所有必要值。 例如,訂用帳戶識別碼、資源群組名稱、資源類型、父代資源名稱 (如有必要) 和資源名稱。 解決資源名稱和類型的錯誤
LocationRequired 提供資源的位置。 ARM 範本中的資源位置

Bicep 檔案中的資源位置
MismatchingResourceSegments 請確定巢狀資源的名稱和類型都有正確的區段數目。 解析資源區段
MissingRegistrationForLocation 檢查資源提供者註冊狀態和支援的位置。 解析註冊
MissingSubscriptionRegistration 向資源提供者註冊訂用帳戶。 解析註冊
NoRegisteredProviderFound 檢查資源提供者註冊狀態。 解析註冊
NotFound 您可以嘗試與父代資源並行部署相依資源。 檢查是否需要新增相依性。 解析相依性
OperationNotAllowed 部署嘗試進行超過訂用帳戶、資源群組或區域配額的作業。 可能的話,請修改您的部署,以維持在配額內。 否則,請考慮要求變更您的配額。 解析配額
ParentResourceNotFound 請確定父代資源在建立子系資源之前即已存在。 解析父代資源
PasswordTooLong 您可能選取了字元太多的密碼,或者在將密碼值作為參數傳遞之前已將密碼值轉換成安全字串。 如果範本包含安全字串參數,則不需要將值轉換為安全字串。 提供密碼值作為文字。
PrivateIPAddressInReservedRange 指定的 IP 位址包含 Azure 所需的位址範圍。 變更 IP 位址以避免保留的範圍。 私人 IP 位址
PrivateIPAddressNotInSubnet 指定的 IP 位址在子網路範圍之外。 變更 IP 位址,使其落在子網路範圍內。 私人 IP 位址
PropertyChangeNotAllowed 有些屬性無法在已部署的資源上變更。 更新資源時,將您的變更限制為允許的屬性。 更新資源
PublicIPCountLimitReached 您已達到執行中公用 IP 數目的限制。 關閉不必要的資源,或連絡 Azure 支援以要求增加。 例如,在 Azure Databricks 中,請參閱非預期的叢集終止IP 位址限制可預防叢集建立 公用 IP 位址限制
RegionDoesNotAllowProvisioning 請選取不同的區域,或提交 [區域存取] 的配額支援要求。
RequestDisallowedByPolicy 您的訂用帳戶包含會讓您無法在部署期間嘗試執行某個動作的資源原則。 尋找封鎖動作的原則。 可能的話,請變更您的部署以符合原則的限制。 解析原則
ReservedResourceName 提供不包含保留名稱的資源名稱。 唯一的資源名稱
ResourceGroupBeingDeleted 等候刪除完成。
ResourceGroupNotFound 檢查部署的目標資源群組名稱。 目標資源群組必須已經存在於您的訂用帳戶中。 檢查訂用帳戶內容。 Azure CLIPowerShell
ResourceNotFound 您的部署會參考無法解析的資源。 確認您使用 reference 函式包括案例的必要參數。 解析參考
ResourceQuotaExceeded 部署嘗試建立資源,這些資源超過訂用帳戶、資源群組或區域的配額。 可能的話,請修改您的基礎結構,以維持在配額內。 否則,請考慮要求變更您的配額。 解析配額
SkuNotAvailable 選取可供您選取之位置使用的 SKU (例如 VM 大小)。 解析 SKU
StorageAccountAlreadyExists
StorageAccountAlreadyTaken
提供儲存體帳戶的唯一名稱。 解析儲存體帳戶名稱
StorageAccountNotFound 檢查您嘗試使用的訂用帳戶、資源群組和儲存體帳戶名稱。
SubnetsNotInSameVnet 虛擬機器只能有一個虛擬網路。 在部署數個 NIC 時,請確定它們屬於相同的虛擬網路。 Windows VM 多個 NIC

Linux VM 多個 NIC
SubnetIsFull 子網路中沒有足夠的可用位址可部署資源。 您可以從子網路釋出位址、使用不同的子網路,或建立新的子網路。 管理子網路虛擬網路常見問題

私人 IP 位址
SubscriptionNotFound 無法存取指定的部署訂用帳戶。 可能是訂用帳戶識別碼錯誤、部署範本的使用者沒有足夠權限可以部署至訂用帳戶,或訂用帳戶識別碼的格式錯誤。 使用 ARM 範本巢狀部署跨範圍部署時,請提供訂用帳戶的 GUID。 跨範圍的 ARM 範本部署

跨範圍的 Bicep 檔案部署
SubscriptionNotRegistered 部署資源時,必須為您的訂用帳戶註冊資源提供者。 當您使用 Azure Resource Manager 範本進行部署時,會在訂用帳戶中自動註冊資源提供者。 有時候,自動註冊未能及時完成。 若要避免此間歇性錯誤,請在部署之前註冊資源提供者。 解析註冊
TemplateResourceCircularDependency 移除不必要的相依性。 解析循環相依性
TooManyTargetResourceGroups 減少單一部署的資源群組數目。 跨範圍的 ARM 範本部署

跨範圍的 Bicep 檔案部署

後續步驟