Freigeben über


Suchen von Fehlercodes

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.

Verwenden Sie zum Identifizieren von Syntaxfehlern Visual Studio Code mit der neuesten Bicep-Erweiterung oder Azure Resource Manager-Tools-Erweiterung.

Überprüfungsfehler

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.

Screenshot: Validierungsfehler im Azure-Portal.

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.

Screenshot: Validierungsfehlermeldung, die einen Syntaxfehler zeigt.

Bereitstellungsfehler

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.

Um Meldungen zu den Vorgängen einer Bereitstellung anzuzeigen, verwenden Sie das Aktivitätsprotokoll der Ressourcengruppe :

  1. Melden Sie sich beim Azure-Portalan.

  2. Wechseln Sie zu Ressourcengruppen, und wählen Sie den Namen der Ressourcengruppe der Bereitstellung aus.

  3. Wählen Sie Aktivitätsprotokoll aus.

  4. Verwenden Sie die Filter, um das Fehlerprotokoll eines Vorgangs zu suchen.

    Screenshot des Aktivitätsprotokolls der Ressourcengruppe, das eine fehlgeschlagene Bereitstellung hervorhebt.

  5. Wählen Sie das Fehlerprotokoll aus, um die Details des Vorgangs anzuzeigen.

    Screenshot der Details des Aktivitätsprotokolls, das die Fehlermeldung einer fehlgeschlagenen Bereitstellung anzeigt.

So zeigen Sie das Ergebnis einer Bereitstellung an

  1. Wechseln Sie zur Ressourcengruppe.

  2. Wählen Sie Einstellungen>Bereitstellungen aus.

  3. Wählen Sie für die Bereitstellung Fehlerdetails aus.

    Screenshot: Link einer Ressourcengruppe zu Fehlerdetails für eine fehlerhafte Bereitstellung.

  4. Die Fehlermeldung und der Fehlercode NoRegisteredProviderFound werden angezeigt.

    Screenshot: Meldung mit Details zu Bereitstellungsfehlern.

Nächste Schritte