Passer au contenu principal
squarecloud blob gère les fichiers de votre Blob Storage. Un fichier est identifié par son ID, que blob list et blob upload affichent. Les commandes nécessitent une clé API avec les 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

Utilisation
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.
Avec --json, la commande affiche les fichiers sous forme de tableau JSON.

squarecloud blob upload

Utilisation
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.
Sortie
  • 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.
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

Utilisation
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.
Avec --json, la commande affiche le lien avec son expiration, sa visibilité, sa taille et son type de contenu.

squarecloud blob delete

Utilisation
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

Utilisation
Indique combien de fichiers vous stockez et quelle part du stockage de votre plan ils utilisent.
Sortie
Avec --json, la commande affiche votre relevé d’utilisation complet au format JSON.

Voir aussi

Pour utiliser Blob Storage depuis votre propre code, commencez par le SDK Blob.