暫停永久 (實) 刪除虛刪除物件

如需更多時間還原虛刪除的物件，以免遭到永久刪除，可以暫停永久刪除 (也稱為實刪除) Cloud Storage bucket 中虛刪除的物件。

根據預設，虛刪除的物件和 bucket 達到虛刪除保留時間長度後，就會永久刪除。暫停 bucket 的實刪除作業後，虛刪除的物件會無限期保留在虛刪除狀態，不受虛刪除保留時間長度影響。只有在您恢復 bucket 的實刪除功能後，虛刪除的物件才會永久刪除。

用途

暫停實刪除作業，可讓您有更多時間執行非常大型或複雜的物件還原作業，否則可能需要比虛刪除保留時間更長的時間才能解決。例如：

  • 復原含有數十億個物件的大型 bucket。如果 bucket 含有大量物件，復原 bucket 中所有物件的時間可能會超過保留期限，尤其是當您在保留期限過了一段時間後才發現刪除作業時。暫停實刪除功能可協助您從非預期的大量刪除事件中復原，而不必為日常作業設定較長的保留期限。
  • 刪除範圍不明確。如果不確定哪些物件誤遭刪除，可能需要花時間調查。暫停永久刪除作業，可讓您有更多時間找出需要還原的內容。
  • 複雜復原作業：如果是複雜的還原作業，您可能有時間在保留期間內偵測並執行大量復原作業。如果未達到預期結果，暫停永久刪除作業可讓您有更多時間確認復原狀態是否符合需求。

建議您採用下列工作流程，暫時停止永久刪除 bucket。如果偵測到大量刪除事件，且解決時間可能超過虛刪除保留期限，請按照下列步驟操作：

  1. 如有需要，請還原 bucket。

  2. 暫停 bucket 的實刪除作業。

  3. 還原 bucket 中的物件。

  4. 完成復原作業並確認資料已成功還原後，請繼續實刪除 bucket。

注意事項

  • 如要暫停 bucket 的實刪除功能，請更新已啟用虛刪除功能的現有 bucket。建立 bucket 時，或 bucket 未啟用虛刪除功能時，無法暫停實刪除。
  • 當您恢復 bucket 的實刪除功能時，Cloud Storage 會根據 bucket 中所有虛刪除物件的虛刪除保留時長，恢復永久刪除這些物件。如果物件已超過保留時間長度，則會在您恢復實刪除時永久刪除。
  • 暫停實刪除會立即生效。快取的 API 作業可能需要幾秒鐘才會傳回更新資訊。
  • 暫停實刪除時，您仍可刪除 bucket 中的物件。刪除的物件會變成虛刪除狀態。
  • 每 24 小時最多可暫停和繼續執行一次 bucket 實刪除作業。
  • 您可以在實刪除功能暫停時，更新虛刪除保留時長。不過，在實刪除功能暫停期間，您無法停用虛刪除功能。
  • 實刪除功能暫停時，無法刪除 bucket。

必要的角色

如要取得暫停或恢復實刪除作業所需的權限，請要求管理員在 bucket 或含有 bucket 的專案中，授予您 Storage 管理員 (roles/storage.admin) IAM 角色。

這個預先定義的角色具備暫停或恢復永久刪除作業所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

必須具備下列權限，才能暫停或恢復實刪除作業：

  • storage.buckets.update
  • 如果您使用 Cloud de Confiance 控制台執行本頁中的工作：
    • storage.buckets.get
    • storage.buckets.list

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

暫停實刪除

控制台

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

    前往「Buckets」(值區) 頁面

  2. 在 bucket 清單中，按一下您感興趣的 bucket 名稱。

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

  4. 在「Soft delete policy (for data recovery)」(虛刪除政策 (用於資料復原)) 專區，按一下「Hard delete enabled」(已啟用實刪除)。

  5. 按一下「確認」。

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

REST API

JSON API

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

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

    {
  "softDeletePolicy": {
    "hardDeletePause": {
      "enabled": true
    }
  }
}

  3. 如要暫停 bucket 的永久刪除作業，請使用 cURL 呼叫 JSON API，並傳送 PATCH Bucket 要求：

    curl -X PATCH --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME"

    更改下列內容：

    • JSON_FILE_NAME：上一個步驟中建立的 JSON 檔案路徑。
    • BUCKET_NAME：bucket 的名稱。例如：my-bucket。

恢復實刪除

控制台

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

    前往「Buckets」(值區) 頁面

  2. 在 bucket 清單中，按一下您感興趣的 bucket 名稱。

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

  4. 在「Soft delete policy (for data recovery)」(虛刪除政策 (適用於資料復原)) 區段中，按一下「Hard delete paused」(實刪除功能已暫停)。

  5. 確認要繼續永久刪除虛刪除的物件，然後按一下「Confirm」(確認)。

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

REST API

JSON API

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

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

    {
  "softDeletePolicy": {
    "hardDeletePause": {
      "enabled": false
    }
  }
}

  3. 如要恢復 bucket 的實刪除，請使用 cURL 呼叫 JSON API，並傳送 PATCH Bucket 要求：

    curl -X PATCH --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME"

    更改下列內容：

    • JSON_FILE_NAME：上一個步驟中建立的 JSON 檔案路徑。
    • BUCKET_NAME：bucket 的名稱。例如：my-bucket。

檢查 bucket 是否暫停實刪除

bucket 的虛刪除政策會提供資訊，說明是否已暫停實刪除。如要瞭解如何擷取 bucket 的虛刪除政策，請參閱「檢查 bucket 是否已啟用虛刪除功能」。

後續步驟