Problembehandlung mit Azure Blueprints
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.
Wählen Sie Alle Dienste im linken Bereich aus. Suchen Sie nach Blaupausen, und wählen Sie die Option aus.
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.
Wählen Sie die Blaupause mit dem Status Fehler aus, oder klicken Sie mit der rechten Maustaste, und wählen Sie Zuweisungsdetails anzeigen aus.
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.