gsutil 是一種 Python 應用程式,可讓您透過指令列存取 Cloud Storage,也可讓您執行多種值區與物件管理工作,包括:
- 建立及刪除值區。
- 上傳、下載及刪除物件。
- 列出值區和物件。
- 移動、複製及重新命名物件。
- 編輯物件和值區 ACL。
gsutil 會使用 HTTPS 和傳輸層安全標準 (TLS) 執行所有作業,包括上傳和下載。
是否應該使用 gsutil?
一般而言,您應該使用 gcloud storage
指令,而不是 gsutil
指令:
gsutil 工具是舊版 Cloud Storage CLI,維護作業極少。
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
指令一樣。下列資源可協助你開始使用:
請按照快速入門導覽課程「使用 gcloud 工具探索物件儲存空間」操作,瞭解
gcloud storage
指令。請參閱
gcloud storage
參考資料。請參閱「Shim for running
gcloud storage
」文件,瞭解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 時,無法使用
Ctrl-C
取消使用-m
全域標記的指令。
後續步驟
- 安裝 gsutil。
- 請參閱 gsutil Stack Overflow 問題中的社群討論。