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

# Dateien in Blob Storage mit der CLI verwalten

> Liste, lade hoch, lösche und verlinke die Dateien in deinem Square Cloud Blob Storage mit squarecloud blob und prüfe, wie viel vom Speicher deines Plans du nutzt.

Mit `squarecloud blob` arbeitest du mit den Dateien in deinem [Blob Storage](https://docs.squarecloud.app/de/services/blob.md). Eine Datei wird über ihre ID identifiziert, die `blob list` und `blob upload` ausgeben.

Die Befehle brauchen einen API-Schlüssel mit den [Scopes](https://docs.squarecloud.app/de/blob-reference/authentication.md#scopes) `blob:read` und `blob:write`. Die Browser-Anmeldung fragt beide an. Einem Schlüssel aus einer Browser-Anmeldung vor Version 3.2.0 fehlen sie: Der erste Blob-Befehl bittet dich dann, `squarecloud auth login` erneut auszuführen. Auch ein Schlüssel in `SQUARECLOUD_API_KEY` braucht beide Scopes.

## `squarecloud blob list`

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

Gibt ID, Größe, Erstellungsdatum und URL jeder Datei aus, oder nur der Dateien unter `prefix`. Eine private Datei zeigt `(private)` statt einer URL.

```bash theme={"system"}
squarecloud blob list avatars/
# Nur die Dateien unter avatars/.
```

Mit `--json` gibt der Befehl die Dateien als JSON-Array aus.

## `squarecloud blob upload`

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

| Flag | Beschreibung |
| - | - |
| `--name <name>` | Speichert die Datei unter diesem Namen, ohne die Endung. Standardmäßig ist der Name der Dateiname ohne seine Endung. |
| `--private` | Speichert die Datei als privat: Sie hat keine öffentliche URL und ist nur über temporäre Links erreichbar. |

Lädt eine Datei hoch und gibt ihre ID und URL aus. Der Dienst behält die Endung der Datei bei. Im Standardnamen werden Zeichen, die der Dienst nicht akzeptiert, durch `_` ersetzt. Um einen Ordner zu senden, zippe ihn zuerst mit [`squarecloud zip`](https://docs.squarecloud.app/de/cli-reference/deploy#squarecloud-zip).

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

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

* **Große Dateien:** Eine Datei über 90 MiB wird in Teilen hochgeladen, sechs gleichzeitig, deren Größe sich nach den Limits richtet, die der Dienst sendet. Der Fortschritt geht nach stderr, sodass stdout nur das Ergebnis enthält.
* **Fehler:** Ein fehlgeschlagener oder mit `Ctrl+C` beendeter Upload wird abgebrochen, sodass er keinen deiner Plätze für offene Uploads belegt. Nur Lesevorgänge und Teile werden wiederholt, nie ein Rate Limit.
* **Private Dateien:** Statt einer URL zeigt die CLI den Befehl, der einen temporären Link erstellt, [`blob url`](#squarecloud-blob-url).

Mit `--json` enthält stdout nur die gespeicherte Datei (ID, Sichtbarkeit, URL und Größe, bei einem Upload in Teilen zusätzlich die Anzahl der Teile) als JSON.

## `squarecloud blob url`

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

Gibt einen Download-Link für eine Datei aus: ihre öffentliche URL oder bei einer privaten Datei einen temporären Link. Nur der Link geht nach stdout, sodass er innerhalb von `$(...)` funktioniert. Bei einem temporären Link nennt die CLI auf stderr, bis wann er gültig ist.

```bash theme={"system"}
curl -o report.pdf "$(squarecloud blob url <ID>)"
# Lädt eine Datei herunter, öffentlich oder privat.
```

Mit `--json` gibt der Befehl den Link mit seinem Ablauf, seiner Sichtbarkeit, Größe und seinem Content-Type aus.

## `squarecloud blob delete`

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

| Flag | Beschreibung |
| - | - |
| `-y`, `--yes` | Überspringt die Bestätigungsabfrage. |

> [!WARNING]
>
> Das Löschen einer Datei ist endgültig: Es gibt keinen Papierkorb.

Fragt vor dem Löschen `Delete <ID> for good? There is no trash [y/N]`. `delete` hat keine JSON-Ausgabe.

## `squarecloud blob stats`

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

Zeigt, wie viele Dateien du speicherst und wie viel vom Speicher deines Plans sie belegen.

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

Mit `--json` gibt der Befehl deinen vollständigen Nutzungsdatensatz als JSON aus.

## Siehe auch

| Befehl | API | Blob-SDK |
| - | - | - |
| `list` | [`GET /v1/objects`](https://docs.squarecloud.app/de/blob-reference/endpoint/list) | [`blob.list()`](https://docs.squarecloud.app/de/sdks/blob/objects#auflisten) |
| `upload` | [`POST /v1/objects`](https://docs.squarecloud.app/de/blob-reference/endpoint/post), [Chunked Upload](https://docs.squarecloud.app/de/blob-reference/endpoint/chunked-init.md) | [`blob.put()`](https://docs.squarecloud.app/de/sdks/blob/uploads) |
| `url` | [`GET /v1/objects/download`](https://docs.squarecloud.app/de/blob-reference/endpoint/download) | [`blob.downloadUrl()`](https://docs.squarecloud.app/de/sdks/blob/objects#download-links) |
| `delete` | [`DELETE /v1/objects`](https://docs.squarecloud.app/de/blob-reference/endpoint/delete) | [`blob.delete()`](https://docs.squarecloud.app/de/sdks/blob/objects#löschen) |
| `stats` | [`GET /v1/account/stats`](https://docs.squarecloud.app/de/blob-reference/endpoint/stats) | [`blob.stats()`](https://docs.squarecloud.app/de/sdks/blob/rules_and_stats#statistiken) |

Um Blob Storage aus deinem eigenen Code zu nutzen, beginne mit dem [Blob-SDK](https://docs.squarecloud.app/de/sdks/blob/client.md).


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