設定及管理虛刪除政策

總覽 使用情形

本頁面說明如何設定及管理虛刪除政策。您可以設定虛刪除政策,為 bucket 啟用虛刪除功能。您也可以更新 bucket 的保留時間長度,並查看現有政策的狀態。

如要瞭解停用虛刪除功能的步驟,請參閱「停用虛刪除功能」。

如要瞭解如何列出及還原虛刪除的物件,請參閱「使用虛刪除的物件」。如要瞭解如何列出及還原虛刪除的 bucket,請參閱「使用虛刪除的 bucket」。

必要的角色

如要取得啟用及管理虛刪除政策所需的權限,請要求管理員針對 bucket 或含有 bucket 的專案,授予您 Storage 管理員 (roles/storage.admin) IAM 角色。

這個預先定義的角色具備啟用及管理虛刪除政策所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

必須具備下列權限,才能啟用及管理虛刪除政策:

  • storage.buckets.get
  • storage.buckets.update
  • storage.buckets.list (只有在您打算使用 Google Cloud 控制台執行本頁的操作說明時,才需要這項權限)

如要瞭解如何授予角色,請參閱「設定及管理 bucket 的 IAM 政策」或「管理專案存取權」。

編輯 bucket 的虛刪除保留時長

編輯 bucket 的虛刪除保留時間長度後,只有在更新後的虛刪除政策生效後刪除的物件或 bucket,才會套用更新後的保留時間長度。現有虛刪除物件不受虛刪除政策更新影響,會按照刪除時生效的保留時間保留。

請按照下列操作說明,編輯 bucket 的虛刪除保留時間長度:

控制台

  1. 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。

    前往「Buckets」(值區) 頁面

  2. 在 bucket 清單中,點選要編輯虛刪除政策的 bucket 名稱。

  3. 按一下「保護」分頁標籤。

  4. 在「Soft delete policy (for data recovery)」(虛刪除政策 (適用於資料復原)) 部分,執行下列操作:

    1. 按一下 [編輯]。

    2. 在「Set a soft delete policy」(設定虛刪除政策) 對話方塊中,選擇時間單位和時間長度,指定虛刪除保留時間長度。

    3. 按一下「儲存」。

如要瞭解如何在 Google Cloud 控制台中取得失敗 Cloud Storage 作業的詳細錯誤資訊,請參閱「疑難排解」。

指令列

如要新增或編輯 bucket 的虛刪除保留時間長度,請使用 gcloud storage buckets update 指令並搭配 --soft-delete-duration 旗標:

gcloud storage buckets update gs://BUCKET_NAME --soft-delete-duration=SOFT_DELETE_DURATION

更改下列內容:

  • BUCKET_NAME:bucket 的名稱。例如:my-bucket。

  • SOFT_DELETE_DURATION:虛刪除保留時間長度。

    • 單位 s 代表秒。
    • 單位 d 代表天數。
    • 單位 m 代表月。

    例如:

    • 7d43200s 會將保留時間長度設為七天半 (7 天和 43,200 秒)。

    • 2w1d 會將保留時間長度設為兩週又一天。

REST API

JSON API

  1. 安裝並初始化 gcloud CLI,以便為 Authorization 標頭產生存取權杖。

  2. 建立含有以下資訊的 JSON 檔案:

    {
      "softDeletePolicy": {
        "retentionDurationSeconds": "TIME_IN_SECONDS"
      }
    }

    將 TIME_IN_SECONDS 替換為要設定的虛刪除保留時間長度 (以秒為單位)。例如,2678400 代表 2,678,400 秒 (31 天)。

  3. 使用 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./storage/v1/b/BUCKET_NAME"

    其中:

    • JSON_FILE_NAME 是您在步驟 2 建立的 JSON 檔案路徑。
    • BUCKET_NAME 是相關 bucket 的名稱。例如:my-bucket。

檢查 bucket 是否已啟用虛刪除功能

控制台

  1. 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。

    前往「Buckets」(值區) 頁面

  2. 在 bucket 清單中,點選要查看虛刪除政策的 bucket 名稱。

  3. 按一下「保護」分頁標籤。

    狀態會顯示在「Soft delete policy (for data recovery)」(虛刪除政策 (適用於資料復原)) 區段。

    這個部分也會顯示是否暫時停止實刪除 (永久刪除)。

如要瞭解如何在 Google Cloud 控制台中取得失敗 Cloud Storage 作業的詳細錯誤資訊,請參閱「疑難排解」。

指令列

如要查看 bucket 的虛刪除政策狀態,請使用 gcloud storage buckets describe 指令:

gcloud storage buckets describe gs://BUCKET_NAME --format="default(soft_delete_policy)"

將 BUCKET_NAME 替換為 bucket 名稱。例如:my-bucket。

REST API

JSON API

  1. 安裝並初始化 gcloud CLI,以便為 Authorization 標頭產生存取權杖。

  2. 使用 cURL 來透過 GET 值區要求呼叫 JSON API:

    curl -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      "https://storage./storage/v1/b/BUCKET_NAME?fields=softDeletePolicy"

    將 BUCKET_NAME 替換為相關 bucket 的名稱。例如:my-bucket。

後續步驟