Usuniętą bazę Cloudflare D1 można odzyskać tylko przez siedem dni

Przypadkowo usunięto bazę Cloudflare D1? Na odzyskanie jej przez API masz teraz siedem dni od momentu usunięcia. Zmianę ogłoszono 23 października 2026 r.: żądania dotyczące baz usuniętych ponad siedem dni wcześniej kończą się błędem. W sytuacji awaryjnej potwierdź identyfikator bazy i jak najszybciej wyślij żądanie undelete.

Co się zmieniło

Metoda odzyskiwania wymaga identyfikatora konta i UUID usuniętej bazy; w treści żądania można podać nową nazwę. Domyślnie baza zostaje przywrócona pod poprzednią nazwą. Jeśli inna baza na koncie używa już tej nazwy, podczas odzyskiwania trzeba podać new_name. Warunki te opisuje dokumentacja interfejsu D1 undelete API.

Okres wynosi siedem dób, czyli 7 × 24 godziny. Dlatego sama data kalendarzowa nie wystarczy: zanotuj czas usunięcia i porównaj go z czasem wysłania żądania. Jeśli termin się zbliża, najpierw wyślij żądanie odzyskania, a następnie sprawdź nazwę i dane.

Procedura działania

1. Znajdź usuniętą bazę. Potwierdź account ID i database ID na podstawie dzienników, kodu infrastruktury lub informacji o incydencie. Ścieżka API używa UUID bazy; sama jej wyświetlana nazwa nie wystarczy do wysłania żądania.
2. Sprawdź okno czasowe. Upewnij się, że od usunięcia minęło mniej niż siedem dób. Cloudflare zaleca wysłanie żądania natychmiast po wykryciu przypadkowego usunięcia.
3. Rozwiąż konflikt nazwy. Jeśli poprzednia nazwa jest już zajęta, przekaż wolną wartość w polu new_name; w przeciwnym razie nie trzeba zmieniać nazwy.
4. Wywołaj udokumentowaną metodę. API używa POST /accounts/{account_id}/d1/database/{database_id}/undelete. Uwierzytelnij żądanie tokenem API z wymaganymi uprawnieniami i nie umieszczaj sekretu w dziennikach.
5. Sprawdź wynik. Po otrzymaniu pomyślnej odpowiedzi upewnij się, że baza pojawiła się na koncie pod oczekiwaną nazwą, a aplikacja łączy się z właściwą instancją.

Undelete i Time Travel służą do różnych zadań

Undelete przywraca usuniętą bazę. Time Travel odtwarza stan istniejącej bazy z wybranego czasu lub bookmarka. Dokumentacja Cloudflare podaje, że historia obejmuje ostatnie 30 dni; rzeczywisty okres zależy od planu. Po użyciu undelete funkcja Time Travel nie może przywrócić bazy do punktu ani czasu sprzed odzyskania. W przypadku błędu w danych działającej bazy użyj Time Travel, a dla usuniętego obiektu — undelete w wyznaczonym terminie.

W procedurze reagowania uwzględnij kontrolę siedmiodniowego okna, a identyfikator bazy i czas jej usunięcia zapisuj w dzienniku incydentu. Ułatwi to szybkie wysłanie prawidłowego żądania i pozwoli uniknąć tracenia czasu na szukanie identyfikatorów oraz ustalanie, czy występuje konflikt nazw.