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
prefix. Eine private Datei zeigt (private) statt einer URL.
--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+Cbeendeter 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.
--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
$(...) funktioniert. Bei einem temporären Link nennt die CLI auf stderr, bis wann er gültig ist.
--json gibt der Befehl den Link mit seinem Ablauf, seiner Sichtbarkeit, Größe und seinem Content-Type aus.
squarecloud blob delete
Verwendung
Fragt vor dem Löschen
Delete <ID> for good? There is no trash [y/N]. delete hat keine JSON-Ausgabe.
squarecloud blob stats
Verwendung
Ausgabe
--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.

