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 コマンドで手動での最適化を少なくする必要があります。

gcloud CLI への移行

gsutil ユーザーが gcloud CLI に移行する場合は、まず次のコマンドを実行して、スタンドアロン バージョンの gsutil を使用しているかどうかを確認します。

See more code actions.
gsutil version -l
  • コマンドの結果に using cloud sdk: False が含まれている場合は、スタンドアロン バージョンの gsutil を使用しています。gcloud CLI に移行するには、まず gcloud CLI をインストールします。

  • コマンドの結果に using cloud sdk: True が含まれている場合は、gcloud CLI がすでにインストールされています。

gcloud CLI をインストールしたら、gsutil コマンドと同様に gcloud storage コマンドを使用できます。使用を開始する際に、以下のリソースが役に立ちます。

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

See more code actions.
gs://BUCKET_NAME/OBJECT_NAME

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

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

特定のコマンドまたはトピックに関する情報を取得するには、gsutil help の後にコマンドまたはトピック名を指定します。たとえば、gsutil help cp はコマンドのヘルプページ、gsutil help options はトピックのヘルプページです。

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

See more code actions.
gsutil version -l

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

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

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