變更物件儲存空間級別

本頁說明如何透過覆寫物件的方式，變更值區中物件的儲存空間級別。要瞭解如何變更物件儲存空間級別而不覆寫物件，請參閱物件生命週期管理功能說明。

Console

您不能使用主控台設定個別物件的儲存空間級別，須改用 gsutil。

gsutil

在 rewrite 指令中使用 -s 旗標。例如：

gsutil rewrite -s [STORAGE_CLASS] gs://[PATH_TO_OBJECT]

其中：

  • [STORAGE_CLASS] 是物件的新儲存空間級別。例如 nearline。
  • [PATH_TO_OBJECT] 是您要變更其類別的物件名稱。例如 pets/dog.png。

REST API

JSON API

  1. 從 OAuth 2.0 Playground 取得授權存取憑證。將 Playground 設為使用自己的 OAuth 憑證。

  2. 建立包含下列資訊的 .json 檔案：

    {
  "storageClass": "[STORAGE_CLASS]"
}

    其中：

  3. 使用 cURL 透過 POST 物件要求呼叫 JSON API：

    curl -X POST --data-binary @[JSON_FILE_NAME].json \
  -H "Authorization: Bearer [OAUTH2_TOKEN]" \
  -H "Content-Type: application/json" \
  "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/o/[OBJECT_NAME]/rewriteTo/b/[BUCKET_NAME]/o/[OBJECT_NAME]"

    其中：

    • [JSON_FILE_NAME] 是您在步驟 2 建立的 JSON 檔案的名稱。
    • [OAUTH2_TOKEN] 是您在步驟 1 中產生的存取憑證。
    • [BUCKET_NAME] 是包含原始物件的值區名稱。例如 my-bucket。
    • [OBJECT_NAME] 是物件的名稱。例如 pets/dog.png。

XML API

  1. 從 OAuth 2.0 Playground 取得授權存取憑證。將 Playground 設為使用自己的 OAuth 憑證。

  2. 使用 cURL 透過 PUT 物件要求叫用 XML API：

    curl -X PUT --data-binary @[OBJECT] \
  -H "Authorization: Bearer [OAUTH2_TOKEN]" \
  -H "Content-Type: [OBJECT_CONTENT_TYPE]" \
  -H "x-goog-storage-class: [STORAGE_CLASS]" \
  "https://storage.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]"

    其中：

    • [OBJECT] 是要變更其儲存空間級別物件的本機路徑 (使用 XML API 變更儲存空間級別時，必須重新上傳該物件)。例如 Desktop/dog.png。
    • [OAUTH2_TOKEN] 是您在步驟 1 中產生的存取憑證。
    • [OBJECT_CONTENT_TYPE] 是物件的內容類型。例如 image/png。
    • [STORAGE_CLASS] 是物件的新儲存空間級別。例如 nearline。
    • [BUCKET_NAME] 是包含要覆寫物件的值區名稱。例如 my-bucket。
    • [OBJECT_NAME] 是您要覆寫的物件名稱。例如，pets/dog.png。