本頁面說明如何啟用、停用及檢查 Cloud Storage 值區設定的自動分類功能狀態。
必要的角色
如要取得在 bucket 上設定及管理自動調整級別功能所需的權限,請要求管理員為您授予 bucket 的儲存空間管理員 (roles/storage.admin
) 身分與存取權管理角色。這個預先定義的角色具備在 bucket 上設定及管理 Autoclass 所需的權限。如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
storage.buckets.get
storage.buckets.list
- 只有使用 Google Cloud 控制台執行這個頁面的工作時,才需要這項權限。
storage.buckets.update
您也可以透過自訂角色取得這些權限。
如要瞭解如何授予值區角色,請參閱「搭配值區使用 IAM」。
為 bucket 設定自動調整級別功能
如要為值區設定 Autoclass,請完成下列步驟:
控制台
- 在 Google Cloud 控制台,前往「Cloud Storage bucket」頁面。
在值區清單中,按一下所需值區的名稱。
在「Bucket details」(值區詳細資料) 頁面中,按一下「Configuration」(設定) 分頁標籤。
按一下「預設儲存空間級別」的「編輯」圖示 (edit)。
在重疊視窗中選取「自動調整級別」,即可啟用這項功能。如要停用 Autoclass,請選取「設定預設類別」,然後選取值區的預設儲存空間類別。
按一下「確認」。
如要為已啟用 Autoclass 的 bucket 變更最終儲存空間級別,請按一下「Included classes」(包含的級別) 的「Edit」(編輯) 圖示 (edit),然後在顯示的疊加視窗中按一下「Confirm」(確認)。
指令列
使用 gcloud storage buckets update
指令並加上適當的旗標:
gcloud storage buckets update gs://BUCKET_NAME --default-storage-class=DEFAULT_CLASS AUTOCLASS_FLAG
其中:
BUCKET_NAME
是相關值區的名稱。例如:my-bucket
。DEFAULT_CLASS
會設定 bucket 的儲存空間級別中繼資料。啟用 Autoclass 時,STANDARD
是唯一有效的值,如果 bucket 目前使用其他儲存空間級別,則必須填寫這個值。AUTOCLASS_FLAG
是下列其中一項:--enable-autoclass
啟用 Autoclass。--no-enable-autoclass
停用自動調整級別功能。--autoclass-terminal-storage-class=CLASS
設定 Autoclass 的最終儲存空間級別。CLASS 可以是NEARLINE
或ARCHIVE
。在停用自動調整級別功能的 bucket 上使用這個旗標時,請在指令中加入--enable-autoclass
旗標。
如果成功,回應會類似以下範例:
Updating gs://my-bucket/... Completed 1
用戶端程式庫
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": "DEFAULT_CLASS", "autoclass": { "enabled": BOOLEAN, "terminalStorageClass":TERMINAL_CLASS } }
其中:
使用
cURL
來透過PATCH
值區要求呼叫 JSON API:curl -X PATCH --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?fields=autoclass"
其中:
JSON_FILE_NAME
是您在步驟 2 建立的 JSON 檔案路徑。BUCKET_NAME
是相關值區的名稱。例如:my-bucket
。
XML API
這項功能無法透過 XML API 管理。請改用Google Cloud 控制台或其他工具。
查看值區的自動調整級別狀態
如要查看個別 bucket 的自動調整級別狀態,請按照下列步驟操作:
控制台
- 在 Google Cloud 控制台,前往「Cloud Storage bucket」頁面。
按一下要檢查狀態的值區名稱。
按一下 [設定] 標籤。
Autoclass 的狀態會顯示在「預設儲存空間類別」欄位中。
如果已啟用 Autoclass,該欄位會顯示「透過 Autoclass 管理」,而「包含的級別」欄位則會顯示物件可轉換的儲存空間級別。
指令列
使用加上 --format
旗標的 gcloud storage buckets describe
指令:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(autoclass)"
其中 BUCKET_NAME
是您要查看狀態的值區名稱。例如:my-bucket
。
如果成功,回應會類似以下範例:
autoclass: enabled: true terminalStorageClass: ARCHIVE terminalStorageClassUpdateTime: '2023-02-10T16:11:02.384000+00:00' toggleTime: '2022-11-09T16:01:40.775000+00:00'
用戶端程式庫
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
標頭產生存取權杖。使用
cURL
透過包含autoclass
欄位的GET
Bucket 要求呼叫 JSON API:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=autoclass"
其中
BUCKET_NAME
是相關值區的名稱。例如:my-bucket
。如果值區已啟用 Autoclass,回應會如下列範例所示:
{ "autoclass": { "enabled": "BOOLEAN", "toggleTime": "DATETIME", "terminalStorageClass": "STORAGE_CLASS", "terminalStorageClassUpdateTime": "DATETIME" }, }
XML API
這項功能無法透過 XML API 管理。請改用Google Cloud 控制台或其他工具。