Michael JohnsonEliminou um banco de dados Cloudflare D1 por engano? Agora há sete dias a partir da exclusão para restaurá-lo pela API. A alteração foi publicada em 23 de outubro de 2026: solicitações para bancos eliminados há mais de sete dias falham. Em uma situação de emergência, confirme o identificador do banco e envie a solicitação undelete o quanto antes.
O que mudou
O método de recuperação recebe o ID da conta e o UUID do banco eliminado; é possível informar um novo nome no corpo da solicitação. Por padrão, o banco volta com o nome anterior. Se outra base na conta já estiver usando esse nome, é preciso especificar new_name para restaurá-lo. Essas condições estão listadas na referência da API undelete do D1.
O prazo é de sete dias, ou 7 × 24 horas. Portanto, apenas a data do calendário não basta: registre a hora da exclusão e compare-a com a hora do envio da solicitação. Se o limite estiver próximo, envie primeiro a solicitação de recuperação e, em seguida, confira o nome e os dados.
Como proceder
- Localize o banco eliminado. Confirme o ID da conta e o ID do banco usando registros, código de infraestrutura ou informações sobre o incidente. O caminho da API usa o UUID do banco; o nome exibido não basta para a solicitação.
- Confira a janela de tempo. Verifique se passaram menos de sete dias desde a exclusão. A Cloudflare recomenda enviar a solicitação assim que a exclusão acidental for descoberta.
- Resolva conflitos de nome. Se o nome anterior já estiver em uso, informe um nome disponível por meio de
new_name; caso contrário, não é necessário alterá-lo. - Chame o método documentado. A API usa
POST /accounts/{account_id}/d1/database/{database_id}/undelete. Autorize a solicitação com um token de API que tenha as permissões necessárias e não inclua o segredo nos registros. - Confira o resultado. Depois de uma resposta bem-sucedida, confirme que o banco apareceu na conta com o nome esperado e verifique se a aplicação se conecta à instância correta.
Undelete e Time Travel resolvem problemas diferentes
Undelete recupera um banco eliminado. O Time Travel restaura o estado de um banco existente com base em um horário ou bookmark. A documentação da Cloudflare informa que o histórico fica disponível pelos últimos 30 dias; o período efetivo depende do plano. Depois do undelete, o Time Travel não consegue restaurar o banco a um marcador ou horário anterior à recuperação. Para corrigir dados em um banco em funcionamento, use o Time Travel; para um objeto eliminado, use undelete dentro do prazo estabelecido.
Para a operação, inclua a verificação da janela de sete dias no procedimento de resposta e guarde o ID do banco junto com a hora da exclusão no registro do incidente. Isso ajudará a enviar rapidamente uma solicitação correta e evitará perda de tempo procurando identificadores e verificando conflitos de nome.