gsutil 工具

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

  • 建立及刪除值區。
  • 上傳、下載及刪除物件。
  • 列出值區和物件。
  • 移動、複製及重新命名物件。
  • 編輯物件和值區 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 後，您就能像使用 gsutil 指令一樣使用 gcloud storage 指令。下列資源可協助你快速上手：

存取資源的語法

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

後續步驟