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.

Pour obtenir la liste complète des guides relatifs à l'exécution de tâches avec gsutil, consultez la page Guides pratiques de Cloud Storage.

Pour bénéficier de l'aide de la communauté, consultez les questions relatives à gsutil sur Stack Overflow.

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 Platform, 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 du SDK Google Cloud 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.

Par défaut, gsutil accède à Cloud Storage via les points de terminaison de requêtes de l'API JSON. Vous pouvez modifier ce comportement par défaut afin d'utiliser l'API XML.

Aide intégrée

gsutil contient une aide intégrée complète sur chaque commande, ainsi qu'un certain nombre de rubriques, que vous pouvez obtenir en exécutant la commande suivante :

gsutil help

Cette commande génère la liste de toutes les commandes et de toutes les rubriques d'aide disponibles. Vous pouvez ensuite obtenir une aide détaillée pour chaque commande ou rubrique. Par exemple, vous pouvez obtenir de l'aide pour la commande gsutil cp en exécutant la commande suivante :

gsutil help cp

Pour obtenir des informations sur les options de ligne de commande de premier niveau gsutil, exécutez la commande suivante :

gsutil help options

Pour obtenir des informations sur votre installation de gsutil, exécutez la commande suivante :

gsutil version -l

Les pages d'aide de gsutil sont également disponibles en ligne. Par exemple, les pages en ligne relatives aux commandes présentées ci-dessus sont gsutil help, gsutil cp, gsutil options et gsutil version.

À 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.

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Besoin d'aide ? Consultez notre page d'assistance.