> ## 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.

# Gérer les fichiers Blob Storage via la CLI

> Listez, téléversez et supprimez les fichiers de votre Blob Storage Square Cloud avec squarecloud blob, obtenez leurs liens et vérifiez quelle part du stockage de votre plan vous utilisez.

`squarecloud blob` gère les fichiers de votre [Blob Storage](https://docs.squarecloud.app/fr/services/blob.md). Un fichier est identifié par son ID, que `blob list` et `blob upload` affichent.

Les commandes nécessitent une clé API avec les [scopes](https://docs.squarecloud.app/fr/blob-reference/authentication.md#scopes) `blob:read` et `blob:write`. La connexion par navigateur demande les deux. Une clé issue d'une connexion par navigateur antérieure à la version 3.2.0 ne les a pas : la première commande Blob vous demande alors d'exécuter à nouveau `squarecloud auth login`. Une clé définie dans `SQUARECLOUD_API_KEY` a aussi besoin des deux scopes.

## `squarecloud blob list`

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

Affiche l'ID, la taille, la date de création et l'URL de chaque fichier, ou uniquement des fichiers sous `prefix`. Un fichier privé affiche `(private)` au lieu d'une URL.

```bash theme={"system"}
squarecloud blob list avatars/
# Uniquement les fichiers sous avatars/.
```

Avec `--json`, la commande affiche les fichiers sous forme de tableau JSON.

## `squarecloud blob upload`

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

| Option | Description |
| - | - |
| `--name <name>` | Enregistre le fichier sous ce nom, sans l'extension. Par défaut, le nom est celui du fichier sans son extension. |
| `--private` | Enregistre le fichier en privé : il n'a pas d'URL publique et n'est accessible que par des liens temporaires. |

Téléverse un fichier et affiche son ID et son URL. Le service conserve l'extension du fichier. Dans le nom par défaut, les caractères que le service n'accepte pas sont remplacés par `_`. Pour envoyer un dossier, compressez-le d'abord avec [`squarecloud zip`](https://docs.squarecloud.app/fr/cli-reference/deploy#squarecloud-zip).

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

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

* **Fichiers volumineux :** un fichier de plus de 90 MiB est envoyé en parties, six à la fois, dimensionnées d'après les limites que le service renvoie. La progression va vers stderr : stdout ne contient donc que le résultat.
* **Échecs :** un envoi qui échoue ou que vous annulez (`Ctrl+C`) est abandonné auprès du service, pour qu'il n'occupe pas l'un de vos emplacements d'envoi ouverts. Seules les lectures et les parties sont réessayées, jamais une limite de débit.
* **Fichiers privés :** au lieu d'une URL, la CLI affiche la commande qui crée un lien temporaire, [`blob url`](#squarecloud-blob-url).

Avec `--json`, stdout ne contient que le fichier enregistré (ID, visibilité, URL et taille, plus le nombre de parties pour un envoi en parties) au format JSON.

## `squarecloud blob url`

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

Affiche un lien de téléchargement pour un fichier : son URL publique, ou un lien temporaire pour un fichier privé. Seul le lien va vers stdout : il fonctionne donc dans `$(...)`. Pour un lien temporaire, la CLI indique sur stderr jusqu'à quand il est valable.

```bash theme={"system"}
curl -o report.pdf "$(squarecloud blob url <ID>)"
# Télécharge un fichier, public ou privé.
```

Avec `--json`, la commande affiche le lien avec son expiration, sa visibilité, sa taille et son type de contenu.

## `squarecloud blob delete`

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

| Option | Description |
| - | - |
| `-y`, `--yes` | Ignore l'invite de confirmation. |

> [!WARNING]
>
> La suppression d'un fichier est définitive : il n'y a pas de corbeille.

Demande `Delete <ID> for good? There is no trash [y/N]` avant de supprimer. `delete` n'a pas de sortie JSON.

## `squarecloud blob stats`

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

Indique combien de fichiers vous stockez et quelle part du stockage de votre plan ils utilisent.

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

Avec `--json`, la commande affiche votre relevé d'utilisation complet au format JSON.

## Voir aussi

| Commande | API | SDK Blob |
| - | - | - |
| `list` | [`GET /v1/objects`](https://docs.squarecloud.app/fr/blob-reference/endpoint/list) | [`blob.list()`](https://docs.squarecloud.app/fr/sdks/blob/objects#lister) |
| `upload` | [`POST /v1/objects`](https://docs.squarecloud.app/fr/blob-reference/endpoint/post), [envoi multipart](https://docs.squarecloud.app/fr/blob-reference/endpoint/chunked-init.md) | [`blob.put()`](https://docs.squarecloud.app/fr/sdks/blob/uploads) |
| `url` | [`GET /v1/objects/download`](https://docs.squarecloud.app/fr/blob-reference/endpoint/download) | [`blob.downloadUrl()`](https://docs.squarecloud.app/fr/sdks/blob/objects#liens-de-téléchargement) |
| `delete` | [`DELETE /v1/objects`](https://docs.squarecloud.app/fr/blob-reference/endpoint/delete) | [`blob.delete()`](https://docs.squarecloud.app/fr/sdks/blob/objects#supprimer) |
| `stats` | [`GET /v1/account/stats`](https://docs.squarecloud.app/fr/blob-reference/endpoint/stats) | [`blob.stats()`](https://docs.squarecloud.app/fr/sdks/blob/rules_and_stats#statistiques) |

Pour utiliser Blob Storage depuis votre propre code, commencez par le [SDK Blob](https://docs.squarecloud.app/fr/sdks/blob/client.md).


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