Outil gsutil

gsutil est une application Python qui vous permet d'accéder à Cloud Storage à partir de la ligne de commande. Vous pouvez l'utiliser pour un large panel de tâches de gestion des buckets et des objets, y compris pour :

  • créer et supprimer des buckets ;
  • importer, télécharger et supprimer des objets ;
  • répertorier des buckets et des objets ;
  • déplacer, copier et renommer des objets ;
  • modifier les listes de contrôle d'accès (LCA) des objets et des buckets.

gsutil effectue toutes les opérations à l'aide des protocoles HTTPS et TLS (Transport-Layer Security), y compris les importations et les téléchargements.

Faut-il utiliser gsutil ?

En règle générale, vous devez utiliser les commandes gcloud storage plutôt que les commandes gsutil :

  • L'outil gsutil est une ancienne CLI Cloud Storage, soumise à une procédure de gestion minimaliste.

  • L'outil gsutil ne permet pas d'utiliser les fonctionnalités Cloud Storage plus récentes.

  • Les commandes gcloud storage nécessitent moins d'optimisation manuelle pour atteindre les taux d'importation et de téléchargement les plus performants.

Syntaxe pour l'accès aux ressources

gsutil utilise le préfixe gs:// pour indiquer une ressource dans Cloud Storage :

gs://BUCKET_NAME/OBJECT_NAME

En plus de spécifier des ressources exactes, gsutil est compatible avec l'utilisation de caractères génériques dans vos commandes.

Aide intégrée

gsutil contient une aide intégrée complète pour chaque commande, ainsi qu'un certain nombre de rubriques, que vous pouvez répertorier et lire à l'aide de la commande gsutil help.

Les pages d'aide de gsutil sont également disponibles en ligne. Par exemple, gsutil cp et gsutil options correspondent respectivement à une page d'aide sur les commandes et à une page d'aide sur les rubriques.

Pour obtenir des informations sur votre installation de gsutil, utilisez la commande gsutil version :

gsutil version -l

Statistiques d'utilisation

Au cours du processus d'installation, vous pouvez choisir d'activer le suivi des statistiques d'utilisation afin d'améliorer l'outil gsutil. Si vous décidez par la suite de désactiver ces statistiques d'utilisation, consultez la page Statistiques d'utilisation.

À propos de gsutil

gsutil est un projet Open Source. Pour télécharger la version développeur de gsutil ou pour participer au développement de gsutil, consultez la page relative au projet gsutil sur GitHub.

Limites

  • Lorsque vous utilisez gsutil avec Windows, les commandes utilisant l'option globale -m ne peuvent pas être annulées à l'aide des touches Ctrl-C.

Étapes suivantes