gsutil 工具

gsutil 是一種 Python 應用程式，可讓您透過指令列存取 Cloud Storage，也可讓您執行多種值區與物件管理工作，包括：

  • 建立及刪除值區。
  • 上傳、下載及刪除物件。
  • 列出值區和物件。
  • 移動、複製及重新命名物件。
  • 編輯物件和值區 ACL。

gsutil 會使用 HTTPS 和傳輸層安全標準 (TLS) 執行所有作業，包括上傳和下載。

是否應使用 gsutil？

一般來說，您應該使用 gcloud storage 指令，而非 gsutil 指令：

  • 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 後，您可以使用 gcloud storage 指令，就像使用 gsutil 指令一樣。以下資源可協助您快速上手：

存取資源的語法

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 取消。

後續步驟