Criar snapshot da aplicação
Gere um snapshot dos arquivos da aplicação em .zip com POST /v2/apps/:app_id/snapshots. Retorna uma URL de download, ou 202 enquanto um snapshot grande é gerado.
POST
Criar snapshot da aplicação
A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.
snapshots:write. A url e a key só são retornadas quando quem chama também pode ler snapshots (uma sessão do dashboard, ou uma chave de API com snapshots:read ou acesso total). Caso contrário, response é um objeto vazio.
Criar Snapshot captura uma cópia .zip do armazenamento completo de uma aplicação em um determinado momento e retorna uma URL de download assinada, dando a você um ponto de restauração antes de uma mudança arriscada ou uma forma de obter um backup completo fora da plataforma. Para trazer a aplicação de volta a esse estado depois, passe o snapshot resultante para Restaurar Snapshot; para inspecionar ou baixar snapshots anteriores sem criar um novo, use Listar Snapshots.
Snapshots estão disponíveis apenas com um plano ativo, e a cota diária escala com a RAM da aplicação ((RAM / 256) × 2 a cada 24 horas). Em aplicações compartilhadas em workspace, quem chama precisa da função admin.
Parâmetros
Comportamento de prazo flexível (soft deadline)
Esta rota segue um modelo de prazo flexível (soft deadline): ela não responde mais sempre de forma síncrona.- Se o snapshot terminar em até ~90 segundos, a rota responde com
200 successe uma URL de download assinada (válida por 1 hora), exatamente como antes. - Se o snapshot levar mais de ~90 segundos para ser gerado, a rota responde imediatamente com
202e o códigoSNAPSHOT_PROCESSING. Isso não é uma falha. O snapshot continua sendo gerado em segundo plano e aparecerá sozinho na listagem de snapshots, normalmente em até ~2 minutos. Esse é o comportamento esperado para aplicações grandes.
Resposta
Retornado quando o snapshot ultrapassa o prazo flexível de ~90 segundos. O snapshot continua sendo gerado em segundo plano e aparecerá sozinho na listagem de snapshots, normalmente em até ~2 minutos. Não é um erro: aguarde e confirme via o endpoint de listagem
GET.Erros
Uma requisição de snapshot pode ser rejeitada com429 Too Many Requests. Use o campo code para distinguir os dois casos:
Cooldown de curto prazo: você atingiu o limite por usuário (1 requisição / 5s) ou por aplicação (1 requisição / 180s). Aguarde um instante e tente novamente.
Cota diária atingida: a conta esgotou o limite diário de snapshots do plano ((RAM / 256) × 2 por 24h). A cota é renovada conforme a janela de 24 horas avança; para um limite diário maior, faça upgrade do plano.
Relacionados
- CLI:
squarecloud app snapshot create - SDKs:
api.apps.snapshots.create()(JavaScript),client.apps.snapshots.create()(Python),c.Apps.Snapshots.Create()(Go)

