本頁面說明如何為 bucket 設定物件生命週期管理,以及如何查看 bucket 目前的生命週期設定。生命週期設定適用於值區中目前和未來的所有物件。
必要的角色
如要取得設定及管理 bucket 物件生命週期管理所需的權限,請要求管理員授予 bucket 的「Storage 管理員」(roles/storage.admin) 角色。這個預先定義的角色具備為 bucket 設定及管理物件生命週期管理所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
storage.buckets.getstorage.buckets.list- 如果您打算使用Cloud de Confiance 控制台執行本頁的操作說明,才需要這項權限。
storage.buckets.update
您或許還可透過自訂角色取得這些權限。
如要瞭解如何授予值區角色,請參閱「設定及管理值區的 IAM 政策」。
設定值區的生命週期設定
控制台
- 前往 Cloud de Confiance 控制台的「Cloud Storage bucket」頁面。
在值區清單中找到要啟用的值區,然後按一下該值區的名稱。
按一下「生命週期」分頁標籤。
隨即會出現生命週期規則頁面。您可以在這裡編輯或刪除現有規則。如要新增規則,請按照下列步驟操作:
點選「新增規則」。
在顯示的頁面中指定設定。
如要瞭解如何透過 Cloud de Confiance 控制台取得 Cloud Storage 作業失敗的詳細錯誤資訊,請參閱「疑難排解」一文。
指令列
使用加上
--lifecycle-file旗標的gcloud storage buckets update指令:gcloud storage buckets update gs://BUCKET_NAME --lifecycle-file=LIFECYCLE_CONFIG_FILE
其中:
BUCKET_NAME是相關值區的名稱。例如:my-bucket。LIFECYCLE_CONFIG_FILE是您在步驟 1 建立的 JSON 檔案路徑。
用戶端程式庫
C++
詳情請參閱「Cloud Storage C++ API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
以下範例是在值區上設定生命週期設定:
下例示範如何從值區移除現有的生命週期設定:
C#
詳情請參閱「Cloud Storage C# API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
以下範例是在值區上設定生命週期設定:
下例示範如何從值區移除現有的生命週期設定:
Go
詳情請參閱「Cloud Storage Go API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
以下範例是在值區上設定生命週期設定:
下例示範如何從值區移除現有的生命週期設定:
Java
詳情請參閱「Cloud Storage Java API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
以下範例是在值區上設定生命週期設定:
下例示範如何從值區移除現有的生命週期設定:
Node.js
詳情請參閱「Cloud Storage Node.js API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
以下範例是在值區上設定生命週期設定:
下例示範如何從值區移除現有的生命週期設定:
PHP
詳情請參閱「Cloud Storage PHP API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
以下範例是在值區上設定生命週期設定:
下例示範如何從值區移除現有的生命週期設定:
Python
詳情請參閱「Cloud Storage Python API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
以下範例是在值區上設定生命週期設定:
下例示範如何從值區移除現有的生命週期設定:
Ruby
詳情請參閱「Cloud Storage Ruby API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
以下範例是在值區上設定生命週期設定:
下例示範如何從值區移除現有的生命週期設定:
Rust
以下範例是在值區上設定生命週期設定:
下例示範如何從值區移除現有的生命週期設定:
Terraform
您可以使用 Terraform 資源,為 Terraform 管理的值區設定生命週期。如要在尚未由 Terraform 管理的現有值區上設定生命週期設定,您必須先匯入現有值區。
如要瞭解 Terraform 是否支援生命週期條件,請參閱 condition 區塊的 Terraform 說明文件。
REST API
JSON API
建立 JSON 檔案,並加入您想套用的 生命週期設定規則。如需範例 JSON 檔案,請參閱設定範例。
使用
cURL來透過PATCH值區要求呼叫 JSON API:curl -X PATCH --data-binary @LIFECYCLE_CONFIG_FILE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=lifecycle"
其中:
LIFECYCLE_CONFIG_FILE是您在步驟 2 建立的 JSON 檔案路徑。BUCKET_NAME是相關值區的名稱。例如:my-bucket。
XML API
建立 XML 檔案,並加入您要套用的 生命週期設定規則。如需 XML 檔案範例,請參閱設定範例。
使用
cURL透過PUT值區要求和lifecycle查詢字串參數來呼叫 XML API:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME?lifecycle"
其中:
XML_FILE_NAME是您在步驟 2 建立的 XML 檔案路徑。BUCKET_NAME是相關值區的名稱。例如:my-bucket。
檢查 bucket 的生命週期設定
控制台
- 前往 Cloud de Confiance 控制台的「Cloud Storage bucket」頁面。
您可以在值區清單中的「Lifecycle」(生命週期) 欄找到每個值區的生命週期狀態。
您可以按一下此狀態來新增、檢視、編輯並刪除規則。
如要瞭解如何透過 Cloud de Confiance 控制台取得 Cloud Storage 作業失敗的詳細錯誤資訊,請參閱「疑難排解」一文。
指令列
使用加上 --format 旗標的 gcloud storage buckets describe 指令:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(lifecycle_config)"
其中 BUCKET_NAME 是您要查看生命週期設定的值區名稱。例如:my-bucket。
用戶端程式庫
C++
詳情請參閱「Cloud Storage C++ API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
C#
詳情請參閱「Cloud Storage C# API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Go
詳情請參閱「Cloud Storage Go API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Java
詳情請參閱「Cloud Storage Java API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Node.js
詳情請參閱「Cloud Storage Node.js API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
PHP
詳情請參閱「Cloud Storage PHP API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Python
詳情請參閱「Cloud Storage Python API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Ruby
詳情請參閱「Cloud Storage Ruby API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Rust
REST API
JSON API
使用
cURL透過GETBucket 要求呼叫 JSON API:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=lifecycle"
其中
BUCKET_NAME是相關值區的名稱。例如:my-bucket。