Pular para o conteúdo principal
O squarecloud blob gerencia os arquivos do seu Blob Storage. Um arquivo é identificado pelo ID, que o blob list e o blob upload imprimem. Os comandos precisam de uma chave de API com os escopos blob:read e blob:write. O login pelo navegador pede os dois. Uma chave de um login pelo navegador anterior à versão 3.2.0 não os tem: o primeiro comando do Blob então pede que você execute squarecloud auth login de novo. Uma chave na SQUARECLOUD_API_KEY também precisa dos dois escopos.

squarecloud blob list

Uso
Imprime o ID, o tamanho, a data de criação e a URL de todos os arquivos, ou só dos arquivos sob prefix. Um arquivo privado mostra (private) no lugar da URL.
Com --json, imprime os arquivos como um array JSON.

squarecloud blob upload

Uso
Envia um arquivo e imprime o ID e a URL dele. O serviço mantém a extensão do arquivo. No nome padrão, os caracteres que o serviço não aceita são trocados por _. Para enviar uma pasta, compacte-a antes com o squarecloud zip.
Saída
  • Arquivos grandes: um arquivo acima de 90 MiB é enviado em partes, seis por vez, com o tamanho definido pelos limites que o serviço envia. O progresso vai para o stderr, então o stdout traz só o resultado.
  • Falhas: um upload que falha ou é cancelado (Ctrl+C) é abortado, para não ocupar uma das suas vagas de upload aberto. Só leituras e partes são repetidas, nunca um rate limit.
  • Arquivos privados: no lugar da URL, a CLI mostra o comando que gera um link temporário, o blob url.
Com --json, o stdout traz só o arquivo armazenado (ID, visibilidade, URL e tamanho, além do número de partes em um upload em partes) em JSON.

squarecloud blob url

Uso
Imprime um link de download para um arquivo: a URL pública dele, ou um link temporário para um arquivo privado. Só o link vai para o stdout, então ele funciona dentro de $(...). Para um link temporário, a CLI informa no stderr até quando ele vale.
Com --json, imprime o link com a expiração, a visibilidade, o tamanho e o tipo de conteúdo.

squarecloud blob delete

Uso
Excluir um arquivo é permanente: não há lixeira.
Pergunta Delete <ID> for good? There is no trash [y/N] antes de excluir. O delete não tem saída em JSON.

squarecloud blob stats

Uso
Mostra quantos arquivos você armazena e quanto do armazenamento do seu plano eles usam.
Saída
Com --json, imprime o registro completo do seu uso em JSON.

Relacionados

Para usar o Blob Storage no seu próprio código, comece pelo SDK do Blob.