快速入門:使用 gsutil 工具

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

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

事前準備

  1. 登入您的 Google 帳戶。

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

  2. 在 GCP 主控台中,前往「Manage resources」(管理資源) 頁面,並建立專案。

    前往「Manage resources」(管理資源) 頁面

  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
需要協助嗎?請前往我們的支援網頁