Listar uso do armazenamento
Consulte
summary.used_bytes, summary.available_bytes, cota total e itens armazenados.Quem pode acessar
O acesso ao armazenamento depende do plano, das permissões da conta e do escopo da credencial usada.Isolamento entre contas
Arquivos de uma conta não são compartilhados com outras contas. Operações como listagem, criação de pasta, preparação de upload, download, renomeação e exclusão validam a conta responsável antes de executar a ação.Limite por arquivo
Cada arquivo enviado ao armazenamento pode ter até1024 MB.
max_size:
Mesmo que o arquivo esteja abaixo de
1024 MB, o upload também depende do espaço disponível na conta.Limite de armazenamento da conta
O espaço total disponível depende do plano ou da configuração aplicada à conta. O uso atual aparece no objetosummary da listagem de itens.
Use
summary.available_bytes para validar uploads grandes antes de gerar uma assinatura.
Quando o limite é atingido
Quando a conta atinge o limite de armazenamento, novos uploads podem ser bloqueados até que espaço seja liberado. Para liberar espaço:- exclua arquivos antigos;
- remova pastas que não são mais necessárias;
- baixe e arquive localmente documentos que não precisam ficar no painel;
- revise arquivos duplicados;
- acompanhe o uso por
summaryantes de novos envios.
Upload assinado
Uploads para armazenamento usam assinatura temporária. O fluxo possui duas etapas:upload_url, signature, signature_expires_at e max_size.
A segunda chamada envia o arquivo para o serviço de upload:
Regras da assinatura
A assinatura temporária valida:- conta responsável pelo envio;
- arquivo preparado;
- nome esperado do arquivo;
- pasta de destino;
- validade da autorização;
- limite máximo permitido;
- permissão para armazenar o arquivo.
Preparar upload
Gere assinatura temporária e registro inicial do arquivo.
Download seguro
Downloads são feitos por links temporários gerados pela API.Gerar download
Gere um link temporário para baixar um arquivo armazenado.
Nomes e duplicidade
Nomes de arquivos e pastas são normalizados antes de salvar. Regras principais:- não é permitido criar duas pastas com o mesmo nome na mesma pasta pai;
- não é permitido manter dois arquivos com o mesmo nome na mesma pasta;
- nomes vazios ou inválidos são recusados;
- caracteres de caminho são removidos ou tratados pela API;
- renomear um item não altera seu identificador interno.
Exclusão
Ao excluir um arquivo, ele deixa de ficar disponível na listagem e no download. Ao excluir uma pasta, arquivos e subpastas internas também entram no fluxo de exclusão. A exclusão pode ser assíncrona, principalmente em pastas com muitos itens.A resposta
202 indica que a exclusão foi iniciada. Ela não garante que todos os objetos internos já foram removidos do storage.Status de arquivo
Bloqueios comuns
Códigos de erro
Consulte erros de permissão, cota, pastas, arquivos, upload e download.
Boas práticas
- Habilite armazenamento para subcontas apenas quando necessário.
- Revise permissões de usuários periodicamente.
- Evite armazenar arquivos sem finalidade operacional.
- Remova arquivos antigos para manter espaço disponível.
- Use pastas para separar documentos sensíveis de arquivos operacionais.
- Confira
summary.available_bytesantes de enviar arquivos grandes. - Não exponha assinaturas de upload ou links temporários em logs públicos.
- Gere uma nova assinatura quando o upload falhar ou expirar.
Próximos passos
Upload e download
Veja como enviar e baixar arquivos no armazenamento.
Pastas e arquivos
Veja como organizar, navegar, renomear e excluir itens.
Preparar upload
Gere assinatura temporária para envio.
Códigos de erro
Consulte erros de armazenamento e upload.