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 還支援在指令中使用萬用字元。

存取檔案清單

如要對大量檔案執行作業，可以使用 -I 旗標將來源檔案清單傳遞至 gsutil。這會告知 gsutil 從 stdin 讀取檔案或物件網址清單，而非從指令列引數讀取。

輸入內容必須是本機檔案路徑或 Cloud Storage 物件網址清單，每行一個路徑。舉例來說，您可以建立名為 example_file_list.txt 的檔案，其中包含下列路徑：

gs://example-source-bucket/data-01.csv
gs://example-source-bucket/images/logo.png
/local/logs/error_log_20251226.txt

下列範例指令會從 example_file_list.txt 讀取檔案路徑，並將其複製到名為 gs://example-destination-bucket 的目的地 bucket：

cat example_file_list.txt | gsutil -m cp -I gs://example-destination-bucket/

您也可以即時產生路徑清單，並直接透過管道傳送至 gsutil。舉例來說，下列指令會上傳目前目錄中的所有 JPG 檔案，並複製到 gs://example-destination-bucket：

find . -name "*.jpg" | gsutil -m cp -I gs://example-destination-bucket

內建說明

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

後續步驟