快速入門導覽課程:使用 gsutil 工具

本頁面說明如何使用 gsutil 指令列工具在 Cloud Storage 中執行基本工作。

您在 Cloud Storage 中產生的費用取決於您使用的資源。本快速入門導覽課程使用的 Cloud Storage 資源通常不會超過 $0.01 美元。

事前準備

  1. 登入您的 Google 帳戶。

    如果您沒有帳戶,請申請新帳戶

  2. 在 GCP Console 的專案選擇器頁面中,按一下 [Create] (建立) 以開始建立新的 GCP 專案。

    前往專案選取器頁面

  3. 請確認您已啟用 Google Cloud Platform 專案的計費功能。瞭解如何確認您已啟用專案的計費功能

  4. 安裝 Cloud SDK

    系統提示時,請在上方選擇您建立的專案。

  5. 安裝 Python 2.7

    如果您使用 Windows,且在安裝 Cloud SDK 時將相關的核取方塊保留勾選,系統就會自動完成這項作業。

建立值區

「值區」是在 Cloud Storage 中保存資料的基本容器。

建立值區:

  1. 開啟終端機視窗。
  2. 使用 gsutil mb 指令和專屬名稱來建立值區:
    gsutil mb -l us-east1 gs://my-awesome-bucket/
    

    指令使用名稱為「my-awesome-bucket」的值區。您必須選擇自己擁有且全域專屬的值區名稱。

    如果成功,指令會傳回下列內容:

    Creating gs://my-awesome-bucket/...
    
  3. 您剛剛建立了值區,可以在此儲存您的內容!

將物件上傳到值區

小貓的圖片。

  1. 在上方的圖片上按一下滑鼠右鍵,並將圖片儲存至電腦的任意位置 (例如桌面)。

  2. 使用 gsutil cp 指令將位於儲存位置的圖片複製到您建立的值區中:

    gsutil cp Desktop/kitten.png gs://my-awesome-bucket

    如果成功,指令會傳回下列內容:

    Copying file://Desktop/kitten.png [Content-Type=image/png]...
    Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
    Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

    您剛剛在值區中儲存了一個物件。

從值區下載物件

  1. 使用 gsutil cp 指令將儲存在值區中的圖片下載至電腦任意位置 (例如桌面):

    gsutil cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

    如果成功,指令會傳回下列內容:

    Copying gs://my-awesome-bucket/kitten.png...
    Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
    Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

    您剛剛下載了值區中的物件。

將物件複製到值區中的資料夾

  1. 使用 gsutil cp 指令建立資料夾並將圖片複製到其中:

    gsutil cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png

    如果成功,指令會傳回下列內容:

    Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
    Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB

    您剛剛已將物件複製到值區中的新資料夾。

列出值區或資料夾的內容

  1. 使用 gsutil ls 指令列出值區頂層的內容:

    gsutil ls gs://my-awesome-bucket

    如果成功,指令會傳回類似以下的訊息:

    gs://my-awesome-bucket/kitten.png
    gs://my-awesome-bucket/just-a-folder/

    您剛剛看到了值區頂層的內容。

列出物件的詳細資料

  1. 使用帶有 -l 旗標的 gsutil ls 指令來獲取有關物件的一些詳細資料:

    gsutil ls -l gs://my-awesome-bucket/kitten.png

    如果成功,指令會傳回類似以下的訊息:

    2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
    TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)

    您剛剛取得了物件大小和建立日期的相關資訊。

將物件設為可公開存取

  1. 使用 gsutil acl ch 指令授予所有使用者對值區中儲存物件的讀取權限:

    gsutil acl ch -u AllUsers:R gs://my-awesome-bucket/kitten.png

    如果成功,指令會傳回下列內容:

    Updated ACL on gs://my-awesome-bucket/kitten.png

    現在任何人都可以存取您的物件。

  2. 如要移除這個權限,請使用指令:

    gsutil acl ch -d AllUsers gs://my-awesome-bucket/kitten.png

    如果成功,指令會傳回下列內容:

    Updated ACL on gs://my-awesome-bucket/kitten.png

    您剛剛移除了這個物件的公開存取權。

向使用者提供值區的存取權

  1. 使用 gsutil iam ch 指令授予特定電子郵件地址讀取及寫入值區中物件的權限:

    gsutil iam ch user:jane@gmail.com:objectCreator,objectViewer gs://my-awesome-bucket

    如果系統未傳回錯誤,即代表指令執行成功。

    現在其他使用者可以把物件放入您的值區,並查看值區內容。

  2. 如要移除這個權限,請使用指令:

    gsutil iam ch -d user:jane@gmail.com:objectCreator,objectViewer gs://my-awesome-bucket

    如果系統未傳回錯誤,即代表指令執行成功。

    您剛剛移除了使用者對這個值區的存取權。

刪除物件

  1. 使用 gsutil rm 指令刪除物件:

    gsutil rm gs://my-awesome-bucket/kitten.png

    如果成功,指令會傳回下列內容:

    Removing gs://my-awesome-bucket/kitten.png...

    Cloud Storage 中已經沒有這個物件的複本 (不過您在 just-a-folder/ 資料夾中建立的副本仍然存在)。

清除所用資源

如要避免系統向您的 GCP 帳戶收取您在本快速入門導覽課程中所用資源的相關費用,請按照下列步驟操作。

  1. 開啟終端機視窗 (如果尚未開啟)。
  2. 使用帶有 -r 旗標的 gsutil rm command 來刪除值區及其中的任何內容:

    gsutil rm -r gs://my-awesome-bucket

    如果成功,指令會傳回類似以下的訊息:

    Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
    Removing gs://my-awesome-bucket/...

    您刪除了值區和其內容。

後續步驟

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Cloud Storage
需要協助嗎?請前往我們的支援網頁