本頁說明如何透過重寫物件的方式,變更值區中物件的儲存空間級別。
必要的角色
如要透過重寫物件變更物件的儲存空間級別,請要求管理員授予您值區的「Storage 物件使用者」(roles/storage.objectUser
) 角色,取得所需權限。
這個角色具備變更物件儲存空間類別所需的權限。如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list
如需如何授予值區角色的操作說明,請參閱「搭配值區使用 IAM」。
變更物件的的儲存空間級別
如要變更物件的儲存空間級別,請完成下列步驟:
控制台
您不能使用Google Cloud 主控台設定個別物件的儲存空間級別,請改用 Google Cloud CLI。
指令列
使用 gcloud storage objects update
指令並加上 --storage-class
旗標。例如:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME --storage-class=STORAGE_CLASS
其中:
BUCKET_NAME
是包含要變更類別物件的值區名稱。例如:my-bucket
。OBJECT_NAME
是您要變更其類別的物件名稱。例如:pets/dog.png
。STORAGE_CLASS
是物件的新儲存空間級別。例如:nearline
。
用戶端程式庫
C++
詳情請參閱 Cloud Storage C++ API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
C#
詳情請參閱 Cloud Storage C# API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Go
詳情請參閱 Cloud Storage Go API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Java
詳情請參閱 Cloud Storage Java API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Node.js
詳情請參閱 Cloud Storage Node.js API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
PHP
詳情請參閱 Cloud Storage PHP API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Python
詳情請參閱 Cloud Storage Python API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Ruby
詳情請參閱 Cloud Storage Ruby API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
REST API
JSON API
安裝並初始化 gcloud CLI,以便為
Authorization
標頭產生存取權杖。建立包含下列資訊的 JSON 檔案:
{ "storageClass": "STORAGE_CLASS" }
其中:
STORAGE_CLASS
是物件的新 儲存空間級別。例如:nearline
。
使用
cURL
透過POST
物件要求呼叫 JSON API:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME/rewriteTo/b/BUCKET_NAME/o/OBJECT_NAME"
其中:
JSON_FILE_NAME
是您在步驟 2 建立的 JSON 檔案路徑。BUCKET_NAME
是包含原始物件的值區名稱。例如:my-bucket
。OBJECT_NAME
是物件的網址編碼名稱。例如pets/dog.png
,網址編碼為pets%2Fdog.png
。
XML API
安裝並初始化 gcloud CLI,以便為
Authorization
標頭產生存取權杖。使用
cURL
透過PUT
物件要求呼叫 XML API:curl -X PUT --data-binary @OBJECT \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: OBJECT_CONTENT_TYPE" \ -H "x-goog-storage-class: STORAGE_CLASS" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
其中:
後續步驟
- 瞭解可用的儲存空間級別。
- 使用物件生命週期管理變更物件儲存空間級別。
- 瞭解其他 Cloud Storage 資料生命週期功能。
- 瞭解物件中繼資料。
- 瞭解如何使用要求前提條件來避免競爭狀況。