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 を使用しているかどうかを確認します。
gsutil version -l
コマンドの結果に
using cloud sdk: False
が含まれている場合は、スタンドアロン バージョンの gsutil を使用しています。gcloud CLI に移行するには、まず gcloud CLI をインストールします。コマンドの結果に
using cloud sdk: True
が含まれている場合は、gcloud CLI がすでにインストールされています。
gcloud CLI をインストールしたら、gsutil
コマンドと同様に gcloud storage
コマンドを使用できます。使用を開始する際に、以下のリソースが役に立ちます。
クイックスタートの gcloud ツールを使用してオブジェクト ストレージを検出するの手順に沿って、
gcloud storage
コマンドを確認します。gcloud storage
リファレンスを読みます。実行中の
gcloud storage
の shim を確認します。gcloud storage
コマンドで使用できない機能が記載されています。
リソースへのアクセス時に使用する構文
gsutil では、接頭辞 gs://
で Cloud Storage 内のリソースを識別します。
gs://BUCKET_NAME /OBJECT_NAME
gsutil では、リソースを正確に指定できるほか、コマンドにワイルドカードを使用できます。
組み込みヘルプ
gsutil には、多くのトピックに加え、コマンドに関する詳しい組み込みヘルプが含まれています。gsutil help
コマンドを実行することで、組み込みヘルプを表示できます。
特定のコマンドまたはトピックに関する情報を取得するには、gsutil help
の後にコマンドまたはトピック名を指定します。たとえば、gsutil help cp
はコマンドのヘルプページ、gsutil help options
はトピックのヘルプページです。
インストールされている gsutil の情報を取得するには、gsutil version
コマンドを使用します。
gsutil version -l
使用統計情報
インストール時に、gsutil ツールの改善に利用される使用統計情報の追跡を有効にできます。その後、こうした使用統計情報を無効にする場合は、使用統計情報をご覧ください。
gsutil について
gsutil はオープンソース プロジェクトです。デベロッパー版の gsutil のダウンロードや gsutil の開発支援の申し出を行うには、GitHub 上の gsutil プロジェクトにアクセスしてください。
制限事項
- Windows で gsutil を使用する場合、
-m
グローバル フラグを使用するコマンドを、Ctrl-C
を使用してキャンセルすることはできません。
次のステップ
- gsutil をインストールする。
- gsutil Stack Overflow に関する質問でコミュニティのディスカッションを閲覧する。