Gelöschte Cloudflare-D1-Datenbanken lassen sich nur sieben Tage lang wiederherstellen

Sie haben versehentlich eine Cloudflare-D1-Datenbank gelöscht? Für die Wiederherstellung per API stehen jetzt sieben Tage ab dem Zeitpunkt der Löschung zur Verfügung. Die Änderung wurde am 23. Oktober 2026 veröffentlicht: Anfragen für Datenbanken, die seit mehr als sieben Tagen gelöscht sind, schlagen fehl. Bestätigen Sie im Notfall die Datenbank-ID und senden Sie die Undelete-Anfrage so schnell wie möglich ab.

Was sich geändert hat

Die Wiederherstellungsmethode benötigt die Konto-ID und die UUID der gelöschten Datenbank; im Anfragekörper kann ein neuer Name angegeben werden. Standardmäßig wird die Datenbank unter ihrem bisherigen Namen wiederhergestellt. Wird dieser Name bereits von einer anderen Datenbank im Konto verwendet, muss für die Wiederherstellung new_name angegeben werden. Diese Bedingungen sind in der Dokumentation zur D1-Undelete-API aufgeführt.

Die Frist beträgt sieben Tage, also 7 × 24 Stunden. Ein Kalenderdatum allein reicht deshalb nicht aus: Halten Sie den Zeitpunkt der Löschung fest und vergleichen Sie ihn mit dem Zeitpunkt, zu dem Sie die Anfrage senden. Ist die Frist fast abgelaufen, senden Sie zuerst die Wiederherstellungsanfrage und prüfen Sie anschließend Namen und Daten.

Vorgehensweise

1. Finden Sie die gelöschte Datenbank. Bestätigen Sie Konto-ID und Datenbank-ID anhand von Protokollen, Infrastrukturcode oder Vorfallsinformationen. Der API-Pfad verwendet die UUID der Datenbank; der angezeigte Name allein reicht für die Anfrage nicht aus.
2. Prüfen Sie das Zeitfenster. Vergewissern Sie sich, dass seit der Löschung weniger als sieben Tage vergangen sind. Cloudflare empfiehlt, die Anfrage unmittelbar nach dem Entdecken der versehentlichen Löschung zu senden.
3. Lösen Sie Namenskonflikte. Wird der bisherige Name bereits verwendet, geben Sie über new_name einen freien Namen an; andernfalls ist keine Namensänderung erforderlich.
4. Rufen Sie die dokumentierte Methode auf. Die API verwendet POST /accounts/{account_id}/d1/database/{database_id}/undelete. Autorisieren Sie die Anfrage mit einem API-Token, das über die erforderlichen Berechtigungen verfügt, und nehmen Sie keine Geheimnisse in Protokolle auf.
5. Prüfen Sie das Ergebnis. Vergewissern Sie sich nach einer erfolgreichen Antwort, dass die Datenbank unter dem erwarteten Namen im Konto erscheint und die Anwendung mit der richtigen Instanz verbunden ist.

Undelete und Time Travel lösen unterschiedliche Aufgaben

Undelete stellt eine gelöschte Datenbank wieder her. Time Travel setzt den Zustand einer bestehenden Datenbank auf einen bestimmten Zeitpunkt oder Bookmark zurück. Laut der Cloudflare-Dokumentation ist der Verlauf der letzten 30 Tage verfügbar; der tatsächlich verfügbare Zeitraum hängt vom Tarif ab. Nach einer Wiederherstellung per Undelete kann Time Travel die Datenbank nicht auf einen Zustand oder Zeitpunkt vor der Wiederherstellung zurücksetzen. Bei fehlerhaften Daten in einer laufenden Datenbank verwenden Sie Time Travel; bei einem gelöschten Objekt nutzen Sie innerhalb der festgelegten Frist Undelete.

Nehmen Sie die Prüfung des Sieben-Tage-Fensters in Ihr Verfahren zur Reaktion auf Vorfälle auf und speichern Sie die Datenbank-ID zusammen mit dem Löschzeitpunkt im Vorfallsprotokoll. So können Sie schnell eine korrekte Anfrage senden, ohne Zeit mit der Suche nach IDs oder der Klärung eines Namenskonflikts zu verlieren.