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.

Faites l'essai

Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de Cloud Storage en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits offerts pour exécuter, tester et déployer des charges de travail.

Profiter d'un essai gratuit de Cloud Storage

Premiers pas

La meilleure façon de vous familiariser avec l'outil gsutil est de suivre le guide de démarrage rapide de gsutil. Ce guide montre comment configurer un projet Google Cloud, activer la facturation, installer gsutil et exécuter des commandes de base avec l'outil.

Si un autre utilisateur a déjà configuré un compte Cloud Storage et vous a ajouté au projet en tant que membre de l'équipe, ou si l'accès à un objet ou à un bucket vous a été octroyé, vous pouvez obtenir gsutil en tant que composant de Google Cloud CLI pour accéder aux données protégées. Vous n'avez pas besoin d'activer Cloud Storage ni de configurer la facturation.

Accéder aux données publiques

Si vous souhaitez seulement accéder aux données publiques, suivez les instructions figurant sur la page Accéder aux données publiques. En suivant les étapes figurant dans l'onglet gsutil, vous pouvez accéder immédiatement et gratuitement aux données publiques. Vous n'avez pas besoin de vous inscrire à un compte Google ou de vous authentifier auprès de Cloud Storage pour utiliser gsutil à cette fin.

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, vous ne pouvez pas utiliser Ctrl-C pour annuler une commande en cours d'exécution.

Étape suivante