使用软删除

概览 用法

本页介绍了如何为存储桶启用、更新软删除政策以及检查其状态。如需了解如何列出和恢复软删除的对象,请参阅使用软删除的对象。如需列出和恢复软删除的存储分区,请参阅使用软删除的存储分区。如需详细了解软删除,请参阅概览。如需停用此功能,请参阅停用软删除

所需的角色

如需获得启用和管理软删除政策所需的权限,请让您的管理员为您授予存储桶或存储桶所属项目的 Storage Admin (roles/storage.admin) IAM 角色。

此预定义角色包含启用和管理软删除政策所需的权限。如需查看所需的确切权限,请展开所需权限部分:

您需要具备以下权限才能启用和管理软删除政策:

  • storage.buckets.get
  • storage.buckets.update
  • storage.buckets.list(只有在您计划使用 Google Cloud 控制台执行本页面上的说明时,才需要此权限)

如需了解如何授予角色,请参阅将 IAM 与存储桶搭配使用管理对项目的访问权限

编辑存储桶的软删除政策

新的软删除保留时长仅适用于您在软删除政策生效后删除的对象或存储分区。现有的软删除对象不会受到对软删除政策所做的更新的影响,并且会保留它们被删除时生效的时长。

按照以下说明编辑存储桶的软删除政策:

  1. 在 Google Cloud 控制台中,前往 Cloud Storage 存储分区页面。

    进入“存储桶”

  2. 在存储桶列表中,点击要管理其软删除政策的存储桶的名称。

  3. 点击保护标签页。

  4. 软删除政策部分中,执行以下操作之一:

    • 如果存储桶没有软删除政策,请点击修改,选择保留时长的时间单位和时间长度,然后点击保存

    • 如果存储桶具有软删除政策,请点击修改以更改保留时长的时间单位和时间长度。

如需了解如何在 Google Cloud 控制台中获取有关失败的 Cloud Storage 操作的详细错误信息,请参阅问题排查

如需添加或修改存储桶的软删除政策,请使用带有 --soft-delete-duration 标志的 gcloud storage buckets update 命令:

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

其中:

  • BUCKET_NAME 是存储桶的名称。例如 my-bucket
  • SOFT_DELETE_DURATION 指定保留软删除对象的时长。例如,2w1d 表示两周零一天。如需了解详情,请参阅软删除保留时长
JSON API
  1. 安装并初始化 gcloud CLI,以便为 Authorization 标头生成访问令牌。

  2. 创建一个包含以下信息的 JSON 文件:

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

    其中,TIME_IN_SECONDS 是您要保留软删除对象的时长(以秒为单位)。例如 2678400。如需了解详情,请参阅 软删除保留时长

  3. 使用 cURL,通过 PATCH Bucket 请求调用 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"

    其中:

    • JSON_FILE_NAME 是您在第 2 步中创建的 JSON 文件的路径。
    • BUCKET_NAME 是相关存储桶的名称,例如 my-bucket

检查存储桶是否启用了软删除政策

  1. 在 Google Cloud 控制台中,前往 Cloud Storage 存储分区页面。

    进入“存储桶”

  2. 在存储桶列表中,点击要检查软删除政策的存储桶的名称。

  3. 点击保护标签页。

    状态会显示在软删除政策(用于数据恢复)部分中。

您还可以使用“保护”标签页来检查存储桶是否有软删除政策。

如需了解如何在 Google Cloud 控制台中获取有关失败的 Cloud Storage 操作的详细错误信息,请参阅问题排查

如需检查存储桶的软删除政策状态,请使用 gcloud storage buckets describe 命令:

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

其中:

  • BUCKET_NAME 是存储桶的名称。例如 my-bucket
JSON API
  1. 安装并初始化 gcloud CLI,以便为 Authorization 标头生成访问令牌。

  2. 使用 cURL 通过 GET Bucket 请求调用 JSON API

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

    其中 BUCKET_NAME 是相关存储桶的名称,例如 my-bucket

后续步骤