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 時，無法使用 Ctrl-C 取消使用 -m 全域標記的指令。

後續步驟