Michael JohnsonHai eliminato per errore un database Cloudflare D1? Ora hai sette giorni dalla cancellazione per ripristinarlo tramite API. La modifica è stata pubblicata il 23 ottobre 2026: le richieste relative a database eliminati da più di sette giorni vengono rifiutate. In caso di incidente, verifica l’identificativo del database e invia la richiesta undelete il prima possibile.
Che cosa è cambiato
Il metodo di ripristino richiede l’ID dell’account e l’UUID del database eliminato; nel corpo della richiesta si può specificare un nuovo nome. Per impostazione predefinita, il database viene ripristinato con il nome precedente. Se un altro database dell’account usa già quel nome, è necessario indicare new_name. Queste condizioni sono elencate nella documentazione dell’API undelete di D1.
Il limite è di sette giorni, ovvero 7 × 24 ore. Perciò non basta considerare la data di calendario: registra l’ora dell’eliminazione e confrontala con quella di invio della richiesta. Se la scadenza è vicina, invia prima la richiesta di ripristino, poi verifica il nome e i dati.
Procedura
- Individua il database eliminato. Verifica l’ID dell’account e quello del database consultando i log, il codice dell’infrastruttura o i dettagli dell’incidente. Il percorso API usa l’UUID del database: il nome visualizzato non è sufficiente per la richiesta.
- Controlla la finestra temporale. Assicurati che siano trascorsi meno di sette giorni dall’eliminazione. Cloudflare consiglia di inviare la richiesta non appena si rileva una cancellazione accidentale.
- Risolvi eventuali conflitti sul nome. Se il nome precedente è già in uso, specificane uno disponibile tramite
new_name; altrimenti non è necessario modificarlo. - Richiama il metodo documentato. L’API usa
POST /accounts/{account_id}/d1/database/{database_id}/undelete. Autorizza la richiesta con un token API dotato dei permessi necessari e non inserire il segreto nei log. - Verifica il risultato. Dopo una risposta positiva, controlla che il database sia comparso nell’account con il nome previsto e che l’applicazione si connetta all’istanza corretta.
Undelete e Time Travel hanno funzioni diverse
Undelete ripristina un database eliminato. Time Travel ripristina lo stato di un database esistente a un determinato momento o bookmark. La documentazione di Cloudflare indica che la cronologia è disponibile per gli ultimi 30 giorni; il periodo effettivo dipende dal piano. Dopo undelete, Time Travel non può riportare il database a un bookmark o a un momento precedente al ripristino. Se i dati di un database ancora attivo sono errati, usa Time Travel; per un oggetto eliminato, usa undelete entro il periodo previsto.
Per la gestione operativa, includi nella procedura di risposta agli incidenti un controllo della finestra di sette giorni e conserva nei log dell’incidente l’ID del database insieme all’ora di eliminazione. In questo modo potrai inviare rapidamente una richiesta corretta, senza perdere tempo a cercare gli identificativi o a chiarire un conflitto sul nome.
