Pular para o conteúdo principal
POST
Restaurar snapshot da aplicação
string
obrigatório
O ID da aplicação ou do banco de dados para o qual o snapshot será restaurado.
string
obrigatório
O ID do snapshot a restaurar.
string
obrigatório
O tipo do recurso. Valores possíveis: applications, databases.
string
Opcional. Substitui o recurso de destino para restauração entre recursos. Se omitido, restaura no recurso informado em id.
boolean
Somente para uma aplicação que roda uma imagem Docker personalizada. Quando true, a restauração também volta para a versão da imagem que a aplicação rodava no momento do snapshot, se ela ainda existir. Padrão false: só os dados são restaurados e a aplicação mantém a versão atual da imagem.

Resposta

object
Confirmação de que o processo de restauração foi iniciado.

Respostas de erro

string
O código de erro que indica o motivo da falha. Valores possíveis:
  • AUTH_TOKEN_MISSING, API_KEY_INVALID, SESSION_REVOKED: o header Authorization está ausente, a chave de API é inválida ou a sessão do painel foi revogada (401).
  • API_KEY_IP_DENIED, API_KEY_SCOPE_DENIED: a chave de API é usada a partir de um IP fora da sua allowlist, ou não tem o escopo que a rota exige (403).
  • USER_NOT_FOUND: o usuário autenticado não foi encontrado.
  • APP_NOT_FOUND: a aplicação informada não existe.
  • DATABASE_NOT_FOUND: o banco de dados informado não existe.
  • ACCESS_DENIED: o usuário não é dono do recurso ou do snapshot.
  • RESTORE_COOLDOWN: uma operação de restauração foi feita neste recurso há pouco tempo. Aguarde antes de tentar de novo.
  • TYPE_MISMATCH: o tipo do recurso do snapshot não corresponde ao tipo do recurso de destino.
  • SNAPSHOT_ENGINE_MISMATCH: o snapshot pertence a um motor de banco de dados diferente do de destino (400).
  • SNAPSHOT_VERSION_NEWER: o snapshot foi feito em uma versão principal mais nova do que a do banco de dados de destino; nada é alterado (400).
  • SNAPSHOT_NOT_FOUND: o snapshot informado não existe.
  • INVALID_ZIP_STRUCTURE: o arquivo do snapshot está danificado, ou um snapshot de aplicação não tem arquivos (400). A restauração é recusada antes de qualquer alteração: os arquivos da aplicação e o banco de dados permanecem como estavam.
  • OPERATION_IN_PROGRESS: outra operação de ciclo de vida no mesmo recurso já está em execução (409). Nada foi restaurado — aguarde alguns segundos e tente de novo. Veja Códigos de erro comuns.
  • SNAPSHOT_IMPORT_FAILED: a restauração falhou ao carregar os dados (500). O banco de dados fica em execução e vazio; o snapshot continua disponível para tentar de novo.
  • INTERNAL_SERVER_ERROR: ocorreu um erro inesperado no servidor.
Última modificação em 28 de outubro de 2026