Wenn eine Azure-Ressourcenbereitstellung unter Verwendung von Azure Resource Manager-Vorlagen (ARM-Vorlagen) oder Bicep-Dateien fehlschlägt, wird ein Fehlercode empfangen. In diesem Artikel wird beschrieben, wie Sie Fehlercodes auffinden können, damit Sie das Problem behandeln können. Weitere Informationen zu Fehlercodes finden Sie unter Häufige Bereitstellungsfehler.
Fehlertypen
Es gibt drei Arten von Fehlern, die mit einer Bereitstellung zusammenhängen:
Validierungsfehler treten auf, bevor ein Einsatz beginnt, und werden durch Syntaxfehler in Ihrer Datei verursacht. Mit einem Code-Editor wie Visual Studio Code können diese Fehler identifiziert werden.
Preflight-Validierungsfehler treten auf, wenn ein Bereitstellungsbefehl zwar ausgeführt wird, Ressourcen aber nicht bereitgestellt werden. Diese Fehler werden gefunden, ohne dass die Bereitstellung gestartet wird. Wenn zum Beispiel ein Parameterwert falsch ist, wird der Fehler bei der Preflight-Validierung gefunden.
Bereitstellungsfehler treten während des Bereitstellungsprozesses auf und können nur durch die Bewertung des Einrichtungsfortschritts in Ihrer Azure-Umgebung gefunden werden.
Alle Fehlertypen geben einen Fehlercode zurück, den Sie bei der Fehlersuche in der Bereitstellung verwenden können. Validierungs- und Preflight-Fehler werden im Aktivitätsprotokoll angezeigt, aber nicht im Bereitstellungsverlauf. Eine Bicep-Datei mit Syntaxfehlern wird weder in JSON kompiliert noch im Aktivitätsprotokoll angezeigt.
Vorlagen werden während des Bereitstellungsprozesses überprüft, und Fehlercodes werden angezeigt. Bevor Sie eine Bereitstellung ausführen, können Sie Validierungs- und Preflight-Fehler identifizieren, indem Sie Validierungstests mit Azure PowerShell oder der Azure CLI ausführen.
Eine ARM-Vorlage kann über das Portal bereitgestellt werden. Wenn die Vorlage Syntaxfehler enthält, wird beim Versuch, die Bereitstellung auszuführen, ein Validierungsfehler angezeigt. Weitere Informationen zu Portalbereitstellungen finden Sie unter Bereitstellen von Ressourcen mithilfe einer benutzerdefinierten Vorlage.
Im folgenden Beispiel wird versucht, ein Speicherkonto bereitzustellen, und es tritt ein Validierungsfehler auf.
Wählen Sie die Meldung aus, um weitere Details zu sehen. Die Vorlage weist einen Syntaxfehler mit dem Fehlercode InvalidTemplate auf. Die Zusammenfassung zeigt, dass einem Ausdruck eine schließende Klammer fehlt.
Die Ausgabe zeigt Fehlercodes wie InvalidTemplateDeployment oder AccountNameInvalid an, mit denen Sie eine Problembehandlung der Vorlage durchführen und sie ggf. korrigieren können.
Bei einer Bicep-Datei wird in der Ausgabe für ein Syntaxvalidierungsproblem ein Parameterfehler angezeigt.
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.
Um weitere Informationen zur Problembehandlung zu erhalten, verwenden Sie den Bicep-Befehl build. Die Ausgabe zeigt die Zeilen- und Spaltennummer jedes Fehlers in Klammern sowie die Fehlermeldung an.
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.
Andere Bereiche
Es gibt Azure PowerShell-Cmdlets, mit denen Bereitstellungsvorlagen für das Abonnement, die Verwaltungsgruppe und die Mandantenbereiche überprüft werden können.
az deployment group validate \
--resource-group examplegroup \
--template-file azuredeploy.json
Die Ausgabe zeigt Fehlercodes wie InvalidTemplateDeployment oder AccountNameInvalid an, mit denen Sie eine Problembehandlung der Vorlage durchführen und sie ggf. korrigieren können.
Bei einer Bicep-Datei zeigt die Ausgabe die Zeilen- und Spaltennummer jedes Fehlers in Klammern sowie die Fehlermeldung an.
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.
Andere Bereiche
Es gibt Azure CLI-Befehle, mit denen Bereitstellungsvorlagen für das Abonnement, die Verwaltungsgruppe und die Mandantenbereiche überprüft werden können.
Mehrere Vorgänge werden verarbeitet, um eine Azure-Ressource bereitzustellen. Bereitstellungsfehler treten auf, wenn ein Vorgang die Überprüfung besteht, aber während der Bereitstellung fehlschlägt. Sie können Meldungen zu jedem Bereitstellungsvorgang und jeder Bereitstellung für eine Ressourcengruppe anzeigen.
Es gibt Azure PowerShell-Cmdlets, mit denen Bereitstellungsinformationen für das Abonnement, die Verwaltungsgruppe und die Mandantenbereiche abgerufen werden können.
az deployment group show \
--resource-group examplegroup \
--name exampledeployment
Andere Bereiche
Es gibt Azure CLI-Befehle, mit denen Bereitstellungsinformationen für das Abonnement, die Verwaltungsgruppe und die Mandantenbereiche abgerufen werden können.