本页介绍了如何为存储桶启用、更新软删除政策以及检查其状态。如需了解如何列出和恢复软删除的对象,请参阅使用软删除的对象。如需列出和恢复软删除的存储分区,请参阅使用软删除的存储分区。如需详细了解软删除,请参阅概览。如需停用此功能,请参阅停用软删除。
所需的角色
如需获得启用和管理软删除政策所需的权限,请让您的管理员为您授予存储桶或存储桶所属项目的 Storage Admin (roles/storage.admin
) IAM 角色。
此预定义角色包含启用和管理软删除政策所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
您需要具备以下权限才能启用和管理软删除政策:
-
storage.buckets.get
-
storage.buckets.update
-
storage.buckets.list
(只有在您计划使用 Google Cloud 控制台执行本页面上的说明时,才需要此权限)
如需了解如何授予角色,请参阅将 IAM 与存储桶搭配使用或管理对项目的访问权限。
编辑存储桶的软删除政策
新的软删除保留时长仅适用于您在软删除政策生效后删除的对象或存储分区。现有的软删除对象不会受到对软删除政策所做的更新的影响,并且会保留它们被删除时生效的时长。
按照以下说明编辑存储桶的软删除政策:
- 在 Google Cloud 控制台中,前往 Cloud Storage 存储分区页面。
在存储桶列表中,点击要管理其软删除政策的存储桶的名称。
点击保护标签页。
在软删除政策部分中,执行以下操作之一:
如果存储桶没有软删除政策,请点击修改,选择保留时长的时间单位和时间长度,然后点击保存。
如果存储桶具有软删除政策,请点击修改以更改保留时长的时间单位和时间长度。
如需了解如何在 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
表示两周零一天。如需了解详情,请参阅软删除保留时长。
安装并初始化 gcloud CLI,以便为
Authorization
标头生成访问令牌。创建一个包含以下信息的 JSON 文件:
{ "softDeletePolicy": { "retentionDurationSeconds": "
TIME_IN_SECONDS " } }其中,
TIME_IN_SECONDS
是您要保留软删除对象的时长(以秒为单位)。例如2678400
。如需了解详情,请参阅 软删除保留时长。使用
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
。
检查存储桶是否启用了软删除政策
- 在 Google Cloud 控制台中,前往 Cloud Storage 存储分区页面。
在存储桶列表中,点击要检查软删除政策的存储桶的名称。
点击保护标签页。
状态会显示在软删除政策(用于数据恢复)部分中。
您还可以使用“保护”标签页来检查存储桶是否有软删除政策。
如需了解如何在 Google Cloud 控制台中获取有关失败的 Cloud Storage 操作的详细错误信息,请参阅问题排查。
如需检查存储桶的软删除政策状态,请使用 gcloud storage buckets describe
命令:
gcloud storage buckets describe gs://BUCKET_NAME \ --format="default(soft_delete_policy)"
其中:
BUCKET_NAME
是存储桶的名称。例如my-bucket
。
安装并初始化 gcloud CLI,以便为
Authorization
标头生成访问令牌。使用
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
。