gsutil ツール

gsutil は、コマンドラインから Cloud Storage にアクセスできる Python アプリケーションです。gsutil を使用すると、次のような、バケットやオブジェクトの幅広い管理作業を行うことができます。

  • バケットの作成と削除
  • オブジェクトのアップロード、ダウンロード、削除
  • バケットとオブジェクトの一覧表示
  • オブジェクトの移動、コピー、名前変更
  • オブジェクトやバケットの ACL の編集

gsutil は、HTTPS と Transport Layer Security(TLS)を使用して、アップロードとダウンロードを含むすべてのオペレーションを実行します。

gsutil を使用するべきかどうか

通常は、gsutil コマンドの代わりに gcloud storage コマンドを使用する必要があります。

  • gsutil ツールは従来の Cloud Storage CLI であり、最小限のメンテナンスが行われます。

  • gsutil ツールは、Cloud Storage の新機能の使用をサポートしていません。

  • 最速のアップロードとダウンロードを達成するには、gcloud storage コマンドで手動での最適化を少なくする必要があります。

リソースへのアクセス時に使用する構文

gsutil では、接頭辞 gs:// で Cloud Storage 内のリソースを識別します。

gs://BUCKET_NAME/OBJECT_NAME

gsutil では、リソースを正確に指定できるほか、コマンドにワイルドカードを使用できます。

組み込みヘルプ

gsutil には、多くのトピックに加え、コマンドに関する詳しい組み込みヘルプが含まれています。gsutil help コマンドを実行することで、組み込みヘルプを表示できます。

gsutil ヘルプページは、オンラインでも利用できます。たとえば、gsutil cp はコマンドのヘルプページ、gsutil options はトピックのヘルプページです。

インストールされている gsutil の情報を取得するには、gsutil version コマンドを使用します。

gsutil version -l

使用統計情報

インストール時に、gsutil ツールの改善に利用される使用統計情報の追跡を有効にできます。その後、こうした使用統計情報を無効にする場合は、使用統計情報をご覧ください。

gsutil について

gsutil はオープンソース プロジェクトです。デベロッパー版の gsutil のダウンロードや gsutil の開発支援の申し出を行うには、GitHub 上の gsutil プロジェクトにアクセスしてください。

制限事項

  • Windows で gsutil を使用する場合、-m グローバル フラグを使用するコマンドを、Ctrl-C を使用してキャンセルすることはできません。

次のステップ