針對常見 Azure 部署錯誤進行疑難排解
本文說明如何針對常見的 Azure 部署錯誤進行疑難排解，並且提供解決方法的資訊。 Azure 資源可使用 Bicep 檔案或 Azure Resource Manager 範本 (ARM 範本) 來部署。 如果您找不到部署錯誤的錯誤碼，請參閱尋找錯誤碼。
如果未列出您的錯誤碼，請提交 GitHub 問題。 在頁面右側，選取 [意見反應]。 在頁面底部的 [意見反應] 底下，選取 [此頁面]。 提供您的文件意見反應，但請勿包含機密資訊，因為 GitHub 問題是公開的。
錯誤碼
| 錯誤碼 | 風險降低 | 其他相關資訊 |
|---|---|---|
| AccountNameInvalid | 遵循儲存體帳戶的命名指導方針。 | 解決儲存體帳戶名稱的錯誤 |
| AccountPropertyCannotBeSet | 檢查可用儲存體帳戶屬性。 | storageAccounts |
| AllocationFailed | 叢集或區域沒有可用的資源或無法支援所要求的 VM 大小。 稍後重試要求，或要求不同的 VM 大小。 | Linux 佈建和配置問題 Windows 佈建和配置問題 為配置失敗進行疑難排解 |
| AnotherOperationInProgress | 等候並行作業完成。 | |
| AuthorizationFailed | 您的帳戶或服務主體沒有完成部署的足夠存取權。 請檢查您的帳戶所屬的角色以及它針對部署範圍的存取權。 當所需的資源提供者未註冊時，您可能會收到此錯誤。 |
Azure 角色型存取控制 (Azure RBAC) 解析註冊 |
| BadRequest | 您傳送的部署值不符合資源管理員的預期。 請查看內部狀態訊息，以取得疑難排解的說明。 使用從現有 Azure 資源匯出的範本時，驗證範本的語法以解決部署錯誤。 |
範本參考 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 | 此錯誤訊息可能有數個原因。 1.部署正在嘗試對指定 SKU 執行不允許的作業。 2.部署嘗試進行超過訂用帳戶、資源群組或區域配額的作業。 可能的話，請修改您的部署，以維持在配額內。 否則，請考慮要求變更您的配額。 |
解析配額 |
| OperationNotAllowedOnVMImageAsVMsBeingProvisioned | 您可能正在嘗試刪除目前用來佈建 VM 的映像。 您無法在部署流程期間刪除任何虛擬機器使用中的映像。 請在 VM 部署完成之後，再重試映像刪除作業。 | |
| 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 CLI PowerShell |
| ResourceNotFound | 您的部署會參考無法解析的資源。 確認您使用 reference 函式包括案例的必要參數。 | 解析參考 |
| ResourceQuotaExceeded | 部署嘗試建立資源，這些資源超過訂用帳戶、資源群組或區域的配額。 可能的話，請修改您的基礎結構，以維持在配額內。 否則，請考慮要求變更您的配額。 | 解析配額 |
| SkuNotAvailable | 選取可供您選取之位置使用的 SKU (例如 VM 大小)。 | 解析 SKU |
| StorageAccountAlreadyTaken StorageAccountAlreadyExists |
提供儲存體帳戶的唯一名稱。 | 解決儲存體帳戶名稱的錯誤 |
| StorageAccountInAnotherResourceGroup | 提供儲存體帳戶的唯一名稱。 | 解決儲存體帳戶名稱的錯誤 |
| StorageAccountNotFound | 檢查您嘗試使用的訂閱、資源群組和儲存體帳戶名稱。 | |
| SubnetsNotInSameVnet | 虛擬機器只能有一個虛擬網路。 在部署數個 NIC 時，請確定它們屬於相同的虛擬網路。 | Windows VM 多重 NIC Linux VM 多重 NIC |
| SubnetIsFull | 子網路中沒有足夠的可用位址可部署資源。 您可以從子網路釋出位址、使用不同的子網路，或建立新的子網路。 | 管理子網路和虛擬網路常見問題 私人 IP 位址 |
| SubscriptionNotFound | 無法存取指定的部署訂閱。 可能是訂閱識別碼錯誤、部署範本的使用者沒有足夠權限可以部署至訂閱，或訂閱識別碼的格式錯誤。 使用 ARM 範本巢狀部署跨範圍部署時，請提供訂閱的 GUID。 | 跨範圍的 ARM 範本部署 跨範圍的 Bicep 檔案部署 |
| SubscriptionNotRegistered | 部署資源時，必須為您的訂用帳戶註冊資源提供者。 當您使用 Azure Resource Manager 範本進行部署時，會在訂閱中自動註冊資源提供者。 有時候，自動註冊未能及時完成。 若要避免此間歇性錯誤，請在部署之前註冊資源提供者。 | 解析註冊 |
| SubscriptionRequestsThrottled | Azure Resource Manager 會在訂用帳戶層級或租用戶層級針對要求進行節流。 資源提供者，例如 Microsoft.Compute，也會節流其作業特有的要求。 達到限制時，您會收到訊息和值，其中包含在傳送新要求之前應該等候的時間量。 例如： Number of requests for subscription '<subscription-id-guid>' and operation '<resource provider>' exceeded the backend storage limit. Please try again after '6' seconds. HTTP 回應會傳回類似 HTTP status code 429 Too Many Requests 的訊息，並具有 Retry-After 值，指定要在傳送另一個要求之前等候的秒數。 |
對 Resource Manager 要求進行節流 針對 API 節流錯誤進行疑難排解：虛擬機器 Azure Kubernetes Service 節流 |
| TemplateResourceCircularDependency | 移除不必要的相依性。 | 解析循環相依性 |
| TooManyTargetResourceGroups | 減少單一部署的資源群組數目。 | 跨範圍的 ARM 範本部署 跨範圍的 Bicep 檔案部署 |