Poistetun Cloudflare D1 -tietokannan voi palauttaa vain seitsemän päivän ajan

Poistitko Cloudflare D1 -tietokannan vahingossa? Sen palauttamiseen API:n kautta on nyt aikaa seitsemän päivää poistamisesta. Muutos julkaistiin 23. lokakuuta 2026: yli seitsemän päivää sitten poistettujen tietokantojen palautuspyynnöt epäonnistuvat. Vahvista häiriötilanteessa tietokannan tunniste ja lähetä undelete-pyyntö mahdollisimman pian.

Mikä muuttui

Palautusmenetelmä tarvitsee tilin ID:n ja poistetun tietokannan UUID:n; pyynnön rungossa voi antaa uuden nimen. Oletusarvoisesti tietokanta palautetaan entisellä nimellään. Jos toinen tilin tietokanta käyttää jo tätä nimeä, palautuksessa on annettava new_name. Nämä ehdot on lueteltu D1 undelete -rajapinnan dokumentaatiossa.

Aikaraja on seitsemän vuorokautta eli 7 × 24 tuntia. Pelkkä kalenteripäivä ei siis riitä: kirjaa poistamisen kellonaika ja vertaa sitä pyynnön lähetysaikaan. Jos määräaika lähestyy, lähetä palautuspyyntö ensin ja tarkista sen jälkeen nimi ja tiedot.

Toimi näin

1. Etsi poistettu tietokanta. Vahvista account ID ja database ID lokeista, infrastruktuurikoodista tai häiriötiedoista. API-polussa käytetään tietokannan UUID:tä; pelkkä näkyvä nimi ei riitä pyyntöön.
2. Tarkista aikaikkuna. Varmista, että poistamisesta on kulunut alle seitsemän vuorokautta. Cloudflare suosittelee lähettämään pyynnön heti, kun virheellinen poisto havaitaan.
3. Ratkaise nimiristiriita. Jos entinen nimi on jo käytössä, anna vapaa nimi kentässä new_name; muussa tapauksessa nimeä ei tarvitse muuttaa.
4. Kutsu dokumentoitua menetelmää. API käyttää osoitetta POST /accounts/{account_id}/d1/database/{database_id}/undelete. Todenna pyyntö API-tunnisteella, jolla on tarvittavat oikeudet, äläkä tallenna salaisuutta lokeihin.
5. Tarkista tulos. Kun saat onnistuneen vastauksen, varmista, että tietokanta näkyy tilillä odotetulla nimellä ja että sovellus muodostaa yhteyden oikeaan tietokantaan.

Undelete ja Time Travel ratkaisevat eri ongelmia

Undelete palauttaa poistetun tietokannan. Time Travel palauttaa olemassa olevan tietokannan tilan valitun ajankohdan tai bookmarkin perusteella. Cloudflaren dokumentaation mukaan historia on saatavilla viimeiseltä 30 päivältä; käytettävissä oleva jakso riippuu tilauksesta. Undelete-palautuksen jälkeen Time Travelilla ei voi palauttaa tietokantaa aikaan tai kohtaan, joka edeltää palautusta. Käytä toimivan tietokannan tietovirheen korjaamiseen Time Traveliä ja poistetun kohteen palauttamiseen undelete-toimintoa määräajan puitteissa.

Lisää seitsemän päivän aikaikkunan tarkistus häiriötilanteiden toimintamalliin ja säilytä tietokannan ID sekä poistamisen ajankohta häiriölokissa. Näin oikean pyynnön lähettäminen nopeutuu, eikä aikaa kulu tunnisteiden etsimiseen tai nimiristiriidan selvittelyyn.