Blob Storage: Armazenamento persistente x temporário

O Blob Storage da Square Cloud foi projetado para oferecer flexibilidade no armazenamento de arquivos, desde logs temporários até assets críticos da sua aplicação. A principal diferença entre os modos de armazenamento está no parâmetro de expiração (expire).

1. Armazenamento Temporário (Expire)

O armazenamento temporário é ideal para arquivos que possuem um ciclo de vida curto, como relatórios gerados sob demanda, backups de transição ou arquivos de cache que não precisam ocupar espaço para sempre.

Como funciona:

Ao realizar o upload, você define o parâmetro expire na URL. O expire aceita de 7 dias a 1825 dias (5 anos), em dias (ex.: 30 ou 30d). No plano Enterprise, também a partir de 1 hora (ex.: 6h).

• Sufixo de expiração: com expire, o nome do objeto ganha um sufixo de expiração.
• Depois do prazo, o objeto é excluído automaticamente.

2. Armazenamento Persistente (Permanente)

O modo persistente é a escolha certa para arquivos que compõem a estrutura da sua aplicação, como fotos de perfil de usuários, logos, CSS, ou documentos que devem estar disponíveis por tempo indeterminado.

Como funciona:

Para tornar um objeto permanente, basta realizar o upload sem o parâmetro expire na URL.

• Substituição (Overwrite): se você enviar um novo arquivo com o exato mesmo nome de um objeto que já existe, o arquivo antigo é substituído, a menos que você mande overwrite=false (aí a API responde 409 OBJECT_ALREADY_EXISTS).
• Vantagem: Facilita a atualização de assets estáticos sem a necessidade de alterar a URL no seu código-fonte.

3. Hash no nome (opcional, nos dois modos)

O hash único no nome (ex.: imagem_<id>.png) é opcional: ative-o com security_hash=true em qualquer modo (objetos privados sempre o têm). Sem hash, enviar um objeto com o mesmo nome substitui o anterior, a menos que você mande overwrite=false (aí volta 409 OBJECT_ALREADY_EXISTS).

4. Comparativo Rápido

5. Qual escolher?

• Use Temporário para: Comprovantes de transação, logs de depuração, arquivos exportados por usuários para download único.
• Use Persistente para: Imagens de interface, uploads de usuários (como avatares) e arquivos de configuração. Para dados estruturados, use um banco gerenciado (PostgreSQL, MySQL, MongoDB ou Redis, a partir do Standard).

Dica Pro: Ao substituir um arquivo, a Square Cloud limpa o cache da borda automaticamente, mas o navegador do visitante pode manter a versão antiga até o Cache-Control expirar.

Atualizado em: 04/10/2026