Skip to main content
O Blob guarda arquivos da sua conta: imagens, backups, anexos, relatórios, o que o seu bot ou site precisar. Os arquivos são privados: ninguém baixa sem um link temporário que você (ou o seu código) pede na hora.

Privado sempre

Nenhum arquivo tem endereço público. O download é por um link que vence em minutos e só abre aquele arquivo.

Direto, sem gastar o projeto

O envio e o download vão direto ao armazenamento, sem passar pela memória nem pela rede dos seus projetos.

Pastas pelo nome

img/logo.png fica na pasta img. Crie quantas pastas quiser, só pelo nome dos arquivos.

Pelo painel, pela API e pela CLI

A página Blob do painel, as rotas /blob/objects e cube blob, com uma chave feita para o código do projeto.

Planos

Cada arquivo tem até 4 GB. A cota conta o que já está guardado e os envios pedidos nos últimos 15 minutos (enquanto o link de envio vale); um envio que passaria dela é recusado, e o que já está no Blob continua lá. Quem desce de plano precisa caber no Blob do plano menor, e quem volta ao Free continua listando, baixando e apagando o que guardou (só não envia mais). Veja Planos e memória.

Pelo painel

1

Abra o Blob

No painel, clique em Blob na barra lateral. Em cima fica o uso da cota.
2

Envie

Arraste os arquivos para a área de envio (ou clique em Escolher arquivos). Eles vão para a pasta aberta, com o progresso na tela. Um arquivo com o mesmo nome é trocado pelo novo, depois de você confirmar.
3

Use

No menu de cada arquivo: Baixar, Copiar link (1 hora) e Apagar. Nova pasta abre uma pasta pelo nome; ela aparece na lista quando tiver um arquivo. A busca procura no nome inteiro, dentro da pasta aberta.
O link do Baixar vale 5 minutos; o do Copiar link, 1 hora. Quem tiver o link baixa o arquivo até lá; depois, ele não abre mais. Apagar o arquivo também desliga os links dele.

Pelo código do projeto

Crie em Chaves de API uma chave com a permissão Só Blob e guarde numa variável de ambiente do projeto, como CUBE_API_KEY. Essa chave lista, envia, baixa e apaga no Blob e nada mais: se ela vazar junto do código, não vê nem para os seus projetos. O envio tem dois passos com a API, mais o arquivo no meio:
Node.js
As rotas estão na Referência da API: listar, pedir o envio, confirmar, ver, pedir o link de download e apagar.
Nunca mande a chave de API no PUT do envio nem no download: o link já traz a autorização dele. E nunca mande a chave para o navegador de quem usa o seu site; entregue só o link temporário.

Pela CLI

Com a CLI na versão 0.2.0 ou mais nova (cube --version):

Segurança

  • Cada arquivo é da sua conta: pedir, baixar ou apagar um arquivo de outra conta responde 404, igual a um que não existe.
  • O download sai sempre como anexo, com o nome do arquivo. HTML, SVG, XML e JavaScript saem como binário: um link do Blob nunca vira página aberta no navegador.
  • Enviar, gerar um link e apagar entram na Atividade da conta, com a chave usada.

Erros

Os códigos do Blob (blob_not_in_plan, blob_quota_exceeded, file_too_large, upload_incomplete…) estão em Códigos de erro.