本页面介绍如何列出和恢复软删除的存储桶。
概览
存储桶被软删除后，在其硬删除时间到来之前由 Cloud Storage 保留，并且在软删除状态下无法修改。硬删除时间至少与存储桶对象的最晚硬删除时间一样长。硬删除时间过去后，Cloud Storage 会永久删除存储桶。恢复软删除的存储桶后，该存储桶会恢复为当前状态，并且删除时存储桶中已有的对象也可以恢复。
注意事项
为了防止恶意删除，软删除的存储桶在其完整的软删除保留时长结束后才能被永久删除。
存储桶被软删除后，您必须先恢复该存储桶，然后才能列出或恢复其中的软删除对象。
如需恢复软删除的存储桶，您必须知道该存储桶的世代编号。如需检索软删除存储桶的世代编号，请参阅列出软删除的存储桶。
只有在没有同名的当前存储桶时，才能恢复软删除的存储桶。如果您或其他任何人创建的存储桶与软删除的存储桶同名，则在删除新存储桶之前，您无法恢复软删除的存储桶。
存储桶恢复操作不会恢复删除时存储桶中已有的软删除对象。如需在软删除的存储桶恢复后恢复软删除的对象，您需要执行对象恢复操作。
当您恢复带标记的软删除存储桶时，标记绑定可能无法恢复。为避免数据丢失，当您恢复具有标记绑定的软删除存储桶时，我们建议您检查以确保存储桶的标记绑定已恢复。如果存储桶的标记绑定未恢复，您需要手动将未恢复的标记绑定到存储桶。
所需权限
如需获得恢复软删除的存储桶所需的权限，请让您的管理员为您授予 Cloud Storage 项目的 Storage Admin (roles/storage.admin) IAM 角色。
此预定义角色包含恢复软删除的存储桶所需的权限。如需查看所需的确切权限，请展开所需权限部分：
所需权限
恢复软删除的存储桶需要以下权限：
-
storage.buckets.list -
storage.buckets.restore
列出软删除的存储桶
您可以执行列出操作来检索软删除存储桶的元数据。
请按照以下说明列出项目中所有的软删除存储桶：
命令行
如需列出所有软删除存储桶，请使用 gcloud storage ls 命令：
gcloud storage ls --buckets --soft-deleted --full
REST API
JSON API
安装并初始化 gcloud CLI，以便为
Authorization标头生成访问令牌。使用
cURL，通过GETBucket 请求调用 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?softDeleted=true"
恢复软删除的存储桶
请按照以下说明恢复软删除的存储桶：
命令行
如需恢复软删除的存储桶，请使用 gcloud storage restore 命令：
gcloud storage restore gs://BUCKET_NAME#GENERATION_NUMBER
替换以下内容：
BUCKET_NAME：要恢复的软删除存储桶的名称。GENERATION_NUMBER：要恢复的软删除存储桶的永久性唯一世代编号。如需获取存储桶的世代编号，请参阅列出软删除的存储桶。
REST API
JSON API
安装并初始化 gcloud CLI，以便为
Authorization标头生成访问令牌。使用
cURL，通过POSTBucket 请求调用 JSON API：curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/restore?generation=GENERATION_NUMBER
其中：
BUCKET_NAME是要恢复的存储桶的名称。例如my-bucket。GENERATION_NUMBER是要恢复的软删除存储桶的永久性唯一世代编号。如需获取存储桶的世代编号，请参阅列出软删除的存储桶。
Cloud Storage 会将软删除的存储桶恢复为有效状态。请注意，恢复存储桶不会恢复软删除时存储桶中已有的对象。如需恢复删除时存储桶中已有的软删除对象，请参阅恢复软删除的对象。