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
を使用してキャンセルすることはできません。
次のステップ
- gsutil をインストールする。
- gsutil Stack Overflow に関する質問でコミュニティのディスカッションを閲覧する。