Zum Hauptinhalt springen
Mit squarecloud blob arbeitest du mit den Dateien in deinem Blob Storage. Eine Datei wird über ihre ID identifiziert, die blob list und blob upload ausgeben. Die Befehle brauchen einen API-Schlüssel mit den 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

Verwendung
Gibt ID, Größe, Erstellungsdatum und URL jeder Datei aus, oder nur der Dateien unter prefix. Eine private Datei zeigt (private) statt einer URL.
Mit --json gibt der Befehl die Dateien als JSON-Array aus.

squarecloud blob upload

Verwendung
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.
Ausgabe
  • 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.
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

Verwendung
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.
Mit --json gibt der Befehl den Link mit seinem Ablauf, seiner Sichtbarkeit, Größe und seinem Content-Type aus.

squarecloud blob delete

Verwendung
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

Verwendung
Zeigt, wie viele Dateien du speicherst und wie viel vom Speicher deines Plans sie belegen.
Ausgabe
Mit --json gibt der Befehl deinen vollständigen Nutzungsdatensatz als JSON aus.

Siehe auch

Um Blob Storage aus deinem eigenen Code zu nutzen, beginne mit dem Blob-SDK.