Silinen Cloudflare D1 veritabanı yalnızca yedi gün içinde geri yüklenebilir

Cloudflare D1 veritabanını yanlışlıkla mı sildiniz? API üzerinden geri yükleme için artık silme anından itibaren yedi gününüz var. Değişiklik 23 Ekim 2026'da duyuruldu: yedi günden daha önce silinen veritabanları için gönderilen istekler hata verir. Acil bir durumda veritabanı kimliğini doğrulayın ve undelete isteğini mümkün olan en kısa sürede gönderin.

Ne değişti?

Geri yükleme yöntemi, hesap kimliğini ve silinmiş veritabanının UUID'sini kabul eder; isteğin gövdesinde yeni bir ad da belirtilebilir. Varsayılan olarak veritabanı eski adıyla geri yüklenir. Bu ad hesapta başka bir veritabanı tarafından kullanılıyorsa, geri yükleme için new_name belirtmeniz gerekir. Bu koşullar D1 undelete API başvuru belgesinde listelenmiştir.

Süre yedi gün, yani 7 × 24 saattir. Bu nedenle yalnızca takvim tarihini bilmek yeterli değildir: silme saatini kaydedin ve istek gönderme saatiyle karşılaştırın. Süre sınırına yaklaşıyorsanız önce geri yükleme isteğini gönderin, ardından adı ve verileri kontrol edin.

İzlenecek adımlar

1. Silinen veritabanını bulun. Günlüklerden, altyapı kodundan veya olay kayıtlarından account ID ve database ID bilgilerini doğrulayın. API yolu veritabanının UUID'sini kullanır; yalnızca görünen ad istek için yeterli değildir.
2. Zaman aralığını kontrol edin. Silme işleminden bu yana yedi günden az geçtiğinden emin olun. Cloudflare, yanlışlıkla silme fark edilir edilmez isteğin gönderilmesini öneriyor.
3. Ad çakışmasını çözün. Eski ad hâlihazırda kullanılıyorsa new_name ile kullanılmayan bir değer gönderin; aksi takdirde adı değiştirmeniz gerekmez.
4. Belgelenmiş yöntemi çağırın. API şu yolu kullanır: POST /accounts/{account_id}/d1/database/{database_id}/undelete. İsteği gerekli izinlere sahip bir API belirteciyle yetkilendirin ve gizli bilgileri günlük kayıtlarına eklemeyin.
5. Sonucu doğrulayın. Başarılı yanıtın ardından veritabanının hesapta beklenen adla göründüğünü ve uygulamanın doğru örneğe bağlandığını kontrol edin.

Undelete ve Time Travel farklı sorunları çözer

Undelete, silinmiş bir veritabanını geri getirir. Time Travel ise mevcut bir veritabanının durumunu belirli bir zamana veya bookmark'a döndürür. Cloudflare belgelerine göre geçmişe dönük veriler son 30 gün için kullanılabilir; gerçek süre plana bağlıdır. Undelete işleminden sonra Time Travel, veritabanını geri yükleme öncesindeki bir işaretçiye veya zamana döndüremez. Çalışan bir veritabanındaki veri hataları için Time Travel'ı, silinmiş bir nesne içinse süre dolmadan undelete'i kullanın.

Operasyon süreçlerinizde yedi günlük süre sınırını kontrol eden bir adım ekleyin ve veritabanı kimliğini silinme saatiyle birlikte olay günlüğünde saklayın. Böylece doğru isteği hızla gönderebilir, kimlikleri aramak ve ad çakışmasını araştırmak için zaman kaybetmezsiniz.