Vai al contenuto principale
squarecloud blob gestisce i file nel tuo Blob Storage. Un file è identificato dal suo ID, che blob list e blob upload stampano. I comandi richiedono una chiave API con gli scope blob:read e blob:write. Il login tramite browser li chiede entrambi. Una chiave di un login tramite browser precedente alla versione 3.2.0 non li ha: il primo comando Blob ti chiede allora di eseguire di nuovo squarecloud auth login. Anche una chiave in SQUARECLOUD_API_KEY ha bisogno di entrambi gli scope.

squarecloud blob list

Utilizzo
Stampa ID, dimensione, data di creazione e URL di ogni file, o solo dei file sotto prefix. Un file privato mostra (private) invece di un URL.
Con --json stampa i file come array JSON.

squarecloud blob upload

Utilizzo
Carica un file e ne stampa ID e URL. Il servizio mantiene l’estensione del file. Nel nome predefinito, i caratteri che il servizio non accetta vengono sostituiti con _. Per inviare una cartella, comprimila prima con squarecloud zip.
Output
  • File di grandi dimensioni: un file oltre i 90 MiB viene caricato in parti, sei alla volta, dimensionate in base ai limiti inviati dal servizio. L’avanzamento va su stderr, così stdout contiene solo il risultato.
  • Fallimenti: un upload fallito o annullato (Ctrl+C) viene interrotto, così non occupa uno dei tuoi slot di upload aperti. Vengono ritentate solo le letture e le parti, mai un rate limit.
  • File privati: invece di un URL, la CLI mostra il comando che crea un link temporaneo, blob url.
Con --json, stdout contiene solo il file salvato (ID, visibilità, URL e dimensione, più il numero di parti per un upload in parti) in formato JSON.

squarecloud blob url

Utilizzo
Stampa un link di download per un file: il suo URL pubblico, o un link temporaneo per un file privato. Su stdout va solo il link, quindi funziona dentro $(...). Per un link temporaneo, la CLI indica su stderr fino a quando è valido.
Con --json stampa il link con la sua scadenza, visibilità, dimensione e tipo di contenuto.

squarecloud blob delete

Utilizzo
L’eliminazione di un file è definitiva: non c’è un cestino.
Prima di eliminare chiede Delete <ID> for good? There is no trash [y/N]. delete non ha un output JSON.

squarecloud blob stats

Utilizzo
Mostra quanti file salvi e quanto storage del tuo piano usano.
Output
Con --json stampa il tuo intero record di utilizzo in formato JSON.

Correlati

Per usare Blob Storage dal tuo codice, parti dall’SDK Blob.