> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestire i file di Blob Storage dalla CLI

> Elenca, carica, elimina e ottieni i link dei file nel tuo Blob Storage di Square Cloud con squarecloud blob, e controlla quanto storage del tuo piano usi.

`squarecloud blob` gestisce i file nel tuo [Blob Storage](https://docs.squarecloud.app/it/services/blob.md). Un file è identificato dal suo ID, che `blob list` e `blob upload` stampano.

I comandi richiedono una chiave API con gli [scope](https://docs.squarecloud.app/it/blob-reference/authentication.md#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`

```bash Utilizzo theme={"system"}
squarecloud blob list [prefix] [--json]
```

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.

```bash theme={"system"}
squarecloud blob list avatars/
# Solo i file sotto avatars/.
```

Con `--json` stampa i file come array JSON.

## `squarecloud blob upload`

```bash Utilizzo theme={"system"}
squarecloud blob upload <file> [--name <name>] [--private] [--json]
```

| Flag | Descrizione |
| - | - |
| `--name <name>` | Salva il file con questo nome, senza l'estensione. Per impostazione predefinita, il nome è quello del file senza la sua estensione. |
| `--private` | Salva il file come privato: non ha un URL pubblico ed è raggiungibile solo tramite link temporanei. |

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`](https://docs.squarecloud.app/it/cli-reference/deploy#squarecloud-zip).

```bash theme={"system"}
squarecloud blob upload ./video.mp4
```

```bash Output theme={"system"}
Uploading video.mp4 (1.20 GB)...
Sent part 77 of 77
✓ Uploaded as <ID>
  <URL>
```

* **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`](#squarecloud-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`

```bash Utilizzo theme={"system"}
squarecloud blob url <id> [--json]
```

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.

```bash theme={"system"}
curl -o report.pdf "$(squarecloud blob url <ID>)"
# Scarica un file, pubblico o privato.
```

Con `--json` stampa il link con la sua scadenza, visibilità, dimensione e tipo di contenuto.

## `squarecloud blob delete`

```bash Utilizzo theme={"system"}
squarecloud blob delete <id> [-y]
```

| Flag | Descrizione |
| - | - |
| `-y`, `--yes` | Salta la richiesta di conferma. |

> [!WARNING]
>
> 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`

```bash Utilizzo theme={"system"}
squarecloud blob stats [--json]
```

Mostra quanti file salvi e quanto storage del tuo piano usano.

```bash Output theme={"system"}
Files: <count>
Storage: <used> used of the <included> in your plan
```

Con `--json` stampa il tuo intero record di utilizzo in formato JSON.

## Correlati

| Comando | API | SDK Blob |
| - | - | - |
| `list` | [`GET /v1/objects`](https://docs.squarecloud.app/it/blob-reference/endpoint/list) | [`blob.list()`](https://docs.squarecloud.app/it/sdks/blob/objects#elencare) |
| `upload` | [`POST /v1/objects`](https://docs.squarecloud.app/it/blob-reference/endpoint/post), [upload a blocchi](https://docs.squarecloud.app/it/blob-reference/endpoint/chunked-init.md) | [`blob.put()`](https://docs.squarecloud.app/it/sdks/blob/uploads) |
| `url` | [`GET /v1/objects/download`](https://docs.squarecloud.app/it/blob-reference/endpoint/download) | [`blob.downloadUrl()`](https://docs.squarecloud.app/it/sdks/blob/objects#link-di-download) |
| `delete` | [`DELETE /v1/objects`](https://docs.squarecloud.app/it/blob-reference/endpoint/delete) | [`blob.delete()`](https://docs.squarecloud.app/it/sdks/blob/objects#eliminare) |
| `stats` | [`GET /v1/account/stats`](https://docs.squarecloud.app/it/blob-reference/endpoint/stats) | [`blob.stats()`](https://docs.squarecloud.app/it/sdks/blob/rules_and_stats#statistiche) |

Per usare Blob Storage dal tuo codice, parti dall'[SDK Blob](https://docs.squarecloud.app/it/sdks/blob/client.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.