Ha egy Azure-erőforrás üzembe helyezése meghiúsul az Azure Resource Manager-sablonokkal (ARM-sablonokkal) vagy Bicep-fájlokkal, egy hibakód jelenik meg. Ez a cikk azt ismerteti, hogyan keresheti meg a hibakódokat, hogy elháríthassa a problémát. A hibakódokkal kapcsolatos további információkért lásd a gyakori üzembehelyezési hibákat.
Hibatípusok
Az üzembe helyezéssel háromféle hiba függ össze:
Az érvényesítési hibák az üzembe helyezés megkezdése előtt fordulnak elő, és a fájl szintaxishibái okozzák. A Visual Studio Code-hoz hasonló kódszerkesztők azonosíthatják ezeket a hibákat.
Előzetes ellenőrzési hibák akkor fordulnak elő, ha egy üzembe helyezési parancs fut, de az erőforrások nincsenek üzembe helyezve. Ezek a hibák az üzembe helyezés elindítása nélkül is felderíthetők. Ha például egy paraméter értéke helytelen, ez a hiba az előzetes ellenőrzés során megtalálható.
Az üzembehelyezési hibák az üzembehelyezési folyamat során fordulnak elő, és csak az üzembe helyezés előrehaladásának az Azure-környezetben történő felmérésével találhatók meg.
Mindhárom típusú hiba az üzembe helyezés hibaelhárításához használható hibakódot ad vissza. Az érvényesítési és elővizsgálati hibák a tevékenységnaplóban megjelennek, de az üzembe helyezési előzményekben nem. Egy szintaktikai hibákat tartalmazó Bicep-fájl nem lesz JSON-re fordítva, és nem jelenik meg a tevékenységnaplóban.
A sablonok érvényesítése az üzembe helyezési folyamat során történik, és hibakódok jelennek meg. Az üzembe helyezés futtatása előtt az érvényesítési és az elővizsgálati hibákat úgy azonosíthatja, hogy érvényesítési teszteket futtat Azure PowerShell vagy az Azure CLI-vel.
Az ARM-sablon a portálról helyezhető üzembe. Ha a sablon szintaxishibákkal rendelkezik, érvényesítési hiba jelenik meg az üzembe helyezés futtatásakor. A portál üzembe helyezésével kapcsolatos további információkért lásd: Erőforrások üzembe helyezése egyéni sablonból.
Az alábbi példa egy tárfiók üzembe helyezését kísérli meg, és érvényesítési hiba történik.
További információért válassza ki az üzenetet. A sablon szintaktikai hibakóddal InvalidTemplaterendelkezik. Az Összefoglalás azt mutatja, hogy egy kifejezésből hiányzik egy záró zárójel.
A kimenet olyan hibakódokat jelenít meg, mint a InvalidTemplateDeployment vagy AccountNameInvalid a sablon hibaelhárításához és javításához.
Bicep-fájlok esetében a szintaxisérvényesítési probléma kimenete paraméterhibát jelez.
Test-AzResourceGroupDeployment: Cannot retrieve the dynamic parameters for the cmdlet.
Cannot find path '/tmp/11111111-1111-1111-1111-111111111111/main.json' because it does not exist.
További hibaelhárítási információkért használja a Bicep build parancsát. A kimenet zárójelben jeleníti meg az egyes hibák sor- és oszlopszámát, valamint a hibaüzenetet.
bicep build main.bicep
/azuredeploy.bicep(22,51) : Error BCP064: Found unexpected tokens in interpolated expression.
/azuredeploy.bicep(22,51) : Error BCP004: The string at this location is not terminated due to an
unexpected new line character.
Egyéb hatókörök
Vannak Azure PowerShell parancsmagok, amelyek ellenőrzik az előfizetés, a felügyeleti csoport és a bérlő hatókörének üzembehelyezési sablonjait.
az deployment group validate \
--resource-group examplegroup \
--template-file azuredeploy.json
A kimenet olyan hibakódokat jelenít meg, mint a InvalidTemplateDeployment vagy AccountNameInvalid a sablon hibaelhárításához és javításához.
Bicep-fájl esetén a kimenet zárójelben jeleníti meg az egyes hibák sor- és oszlopszámát, valamint a hibaüzenetet.
az deployment group validate \
--resource-group examplegroup \
--template-file main.bicep
/azuredeploy.bicep(22,51) : Error BCP064: Found unexpected tokens in interpolated expression.
/azuredeploy.bicep(22,51) : Error BCP004: The string at this location is not terminated due to an
unexpected new line character.
Egyéb hatókörök
Vannak Azure CLI-parancsok az előfizetés, a felügyeleti csoport és a bérlői hatókör üzembehelyezési sablonjainak ellenőrzéséhez.
Számos művelet feldolgozása történik egy Azure-erőforrás üzembe helyezéséhez. Üzembehelyezési hibák akkor fordulnak elő, ha egy művelet megfelel az ellenőrzésen, de az üzembe helyezés során meghiúsul. Megtekintheti az egyes üzembehelyezési műveletről és az erőforráscsoportok egyes üzembe helyezéséről szóló üzeneteket.