Problembehandlung mit Azure Blueprints

  • Artikel

Wichtig

Am 11. Juli 2026 läuft Blueprints (Vorschau) aus. Migrieren Sie Ihre vorhandenen Blaupausendefinitionen und -zuweisungen zu Vorlagenspezifikationen und Bereitstellungsstapeln. Blaupausenartefakte müssen in ARM-JSON-Vorlagen oder Bicep-Dateien konvertiert werden, die zum Definieren von Bereitstellungsstapeln verwendet werden. Informationen zum Erstellen eines Artefakts als ARM-Ressource finden Sie unter:

Beim Erstellen, Zuweisen oder Entfernen von Blaupausen können Fehler auftreten. In diesem Artikel wird beschrieben, welche Fehler auftreten und wie diese behoben werden können.

Ermitteln von Fehlerdetails

Viele Fehler sind das Ergebnis der Zuweisung einer Blaupause zu einem Bereich. Wenn bei einer Zuweisung ein Fehler auftritt, finden Sie in der Blaupause Informationen zur fehlerhaften Bereitstellung. Diese Informationen enthalten Hinweise zum Problem, damit Sie es beheben können und die nächste Bereitstellung erfolgreich verläuft.

  1. Wählen Sie Alle Dienste im linken Bereich aus. Suchen Sie nach Blaupausen, und wählen Sie die Option aus.

  2. Wählen Sie auf der linken Seite Zugewiesene Blaupausen aus, und verwenden Sie das Suchfeld, um die Blaupausenzuweisungen zu filtern und nach der fehlerhaften Zuweisung zu suchen. Sie können die Tabelle der Zuweisungen auch nach der Spalte Bereitstellungsstatus sortieren, um alle fehlerhaften Zuweisungen gruppiert anzuzeigen.

  3. Wählen Sie die Blaupause mit dem Status Fehler aus, oder klicken Sie mit der rechten Maustaste, und wählen Sie Zuweisungsdetails anzeigen aus.

  4. In einem roten Banner oben auf der Seite „Blaupausenzuweisung“ wird darauf hingewiesen, dass die Zuweisung fehlerhaft ist. Wählen Sie eine beliebige Stelle des Banners aus, um weitere Details anzuzeigen.

Es ist üblich, dass der Fehler durch ein Artefakt und nicht durch die Blaupause als Ganzes verursacht wird. Wenn ein Artefakt eine Key Vault-Instanz erstellt und Azure Policy die Key Vault-Erstellung verhindert, tritt für die gesamte Zuweisung ein Fehler auf.

Allgemeine Fehler

Szenario: Richtlinienverletzung

Problem

Bei der Vorlagenbereitstellung ist aufgrund einer Richtlinienverletzung ein Fehler aufgetreten.

Ursache

Aus den folgenden Gründen kann es bei einer Bereitstellung zu einem Richtlinienkonflikt kommen:

  • Die zu erstellende Ressource ist durch Richtlinien eingeschränkt (üblicherweise SKU- oder Standortbeschränkungen).
  • Die Bereitstellung legt Felder fest, die über die Richtlinie konfiguriert werden (häufig mit Tags).

Lösung

Ändern Sie die Blaupause so, dass sie nicht in Konflikt mit den Richtlinien in den Fehlerdetails steht. Wenn diese Änderung nicht möglich ist, besteht eine alternative Option darin, den Umfang der Richtlinienzuordnung so zu ändern, dass die Blaupause der Richtlinie nicht mehr widerspricht.

Szenario: Blaupausenparameter ist eine Funktion

Problem

Blaupausenparameter, die Funktionen sind, werden vor der Übergabe an Artefakte verarbeitet.

Ursache

Die Übergabe eines Blaupausenparameters, der eine Funktion verwendet, wie z.B. [resourceGroup().tags.myTag], an ein Artefakt resultiert darin, dass das verarbeitete Ergebnis der Funktion auf dem Artefakt anstelle der dynamischen Funktion festgelegt wird.

Lösung

Um eine Funktion als Parameter zu übergeben, versehen Sie die gesamte Zeichenfolge mit [ als Escapezeichen, sodass der Blaupausenparameter aussieht wie [[resourceGroup().tags.myTag]. Das Escapezeichen bewirkt, dass Blueprints den Wert bei der Verarbeitung der Blaupause als Zeichenfolge behandelt. Dann platziert der Blueprints-Dienst die Funktion auf dem Artefakt, sodass sie so dynamisch wie erwartet sein kann. Weitere Informationen finden Sie unter Syntax und Ausdrücke in Azure Resource Manager-Vorlagen.

Löschen von Fehlern

Szenario: Timeout beim Löschen einer Zuweisung

Problem

Das Löschen einer Blaupausenzuweisung wird nicht abgeschlossen.

Ursache

Wenn eine Blaupausenzuweisung gelöscht wird, kann es vorkommen, dass sie in einem Nicht-Endzustand verbleibt. Dieser Zustand wird erzeugt, wenn das Löschen von Ressourcen, die von der Blaupausenzuweisung erstellt wurden, noch aussteht, oder wenn diese keinen Statuscode an Azure Blueprints zurückgeben.

Lösung

Blaupausenzuweisungen in einem Nicht-Endzustand werden nach einem Timeout von sechs Stunden automatisch als Fehlerhaft markiert. Nachdem der Timeout den Zustand der Blaupausenzuweisung angepasst hat, kann der Löschvorgang wiederholt werden.

Nächste Schritte

Wenn Ihr Problem nicht aufgeführt ist oder Sie es nicht lösen können, besuchen Sie einen der folgenden Kanäle, um weitere Unterstützung zu erhalten:

  • Erhalten Sie Antworten von Azure-Experten über Azure-Foren.
  • Mit @AzureSupport verbinden – das offizielle Microsoft Azure-Konto für die Verbesserung der Kundenzufriedenheit durch Verbinden der Azure-Community mit den richtigen Ressourcen: Antworten, Support und Experten.
  • Wenn Sie weitere Hilfe benötigen, können Sie einen Azure-Supportvorgang anlegen. Rufen Sie die Azure-Support-Website auf, und wählen Sie Support erhaltenaus.