本页面介绍了如何在存储桶上设置对象生命周期管理,以及如何查看存储桶的当前生命周期配置。生命周期配置适用于存储桶中的所有当前和未来的对象。
所需的角色
如需获得设置和管理存储桶的对象生命周期管理所需的权限,请让管理员向您授予存储桶的 Storage Admin (roles/storage.admin
) 角色。此预定义角色包含设置和管理存储桶的对象生命周期管理所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
storage.buckets.get
storage.buckets.list
- 仅当您计划使用 Google Cloud 控制台执行本页面上的任务时,才需要此权限。
storage.buckets.update
您也可以使用自定义角色来获取这些权限。
如需了解如何授予存储桶的角色,请参阅将 IAM 与存储桶搭配使用。
设置存储桶的生命周期配置
控制台
- 在 Google Cloud 控制台中,进入 Cloud Storage 存储桶页面。
在存储桶列表中,找到要启用的存储桶,然后点击存储桶的名称。
点击生命周期标签页。
随即将显示生命周期规则页面。 在这里,您可以修改或删除现有规则。如需添加新规则,请执行以下操作:
点击添加规则。
在出现的页面中,指定配置。
如需了解如何在 Google Cloud 控制台中获取失败的 Cloud Storage 操作的详细错误信息,请参阅问题排查。
命令行
使用带有
--lifecycle-file
标志的gcloud storage buckets update
命令:gcloud storage buckets update gs://BUCKET_NAME --lifecycle-file=LIFECYCLE_CONFIG_FILE
其中:
BUCKET_NAME
是相关存储桶的名称,例如my-bucket
。LIFECYCLE_CONFIG_FILE
是您在第 1 步中创建的 JSON 文件的路径。
客户端库
C++
如需了解详情,请参阅 Cloud Storage C++ API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
以下示例在存储桶上设置生命周期配置:
以下示例从存储桶中移除任何现有生命周期配置:
C#
如需了解详情,请参阅 Cloud Storage C# API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
以下示例在存储桶上设置生命周期配置:
以下示例从存储桶中移除任何现有生命周期配置:
Go
如需了解详情,请参阅 Cloud Storage Go API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
以下示例在存储桶上设置生命周期配置:
以下示例从存储桶中移除任何现有生命周期配置:
Java
如需了解详情,请参阅 Cloud Storage Java API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
以下示例在存储桶上设置生命周期配置:
以下示例从存储桶中移除任何现有生命周期配置:
Node.js
如需了解详情,请参阅 Cloud Storage Node.js API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
以下示例在存储桶上设置生命周期配置:
以下示例从存储桶中移除任何现有生命周期配置:
PHP
如需了解详情,请参阅 Cloud Storage PHP API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
以下示例在存储桶上设置生命周期配置:
以下示例从存储桶中移除任何现有生命周期配置:
Python
如需了解详情,请参阅 Cloud Storage Python API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
以下示例在存储桶上设置生命周期配置:
以下示例从存储桶中移除任何现有生命周期配置:
Ruby
如需了解详情,请参阅 Cloud Storage Ruby API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
以下示例在存储桶上设置生命周期配置:
以下示例从存储桶中移除任何现有生命周期配置:
Terraform
您可以使用 Terraform 资源为由 Terraform 管理的存储桶设置生命周期配置。如需在并未由 Terraform 管理的现有存储桶上设置生命周期配置,您必须先导入现有存储桶。
如需了解 Terraform 是否支持某个生命周期条件,请参阅 Terraform 文档中的 condition
块部分。
REST API
JSON API
安装并初始化 gcloud CLI,以便为
Authorization
标头生成访问令牌。使用
cURL
,通过PATCH
Bucket 请求调用 JSON API:curl -X PATCH --data-binary @LIFECYCLE_CONFIG_FILE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
其中:
LIFECYCLE_CONFIG_FILE
是您在第 2 步中创建的 JSON 文件的路径。BUCKET_NAME
是相关存储桶的名称,例如my-bucket
。
XML API
安装并初始化 gcloud CLI,以便为
Authorization
标头生成访问令牌。使用
cURL
,通过PUT
Bucket 请求和lifecycle
查询字符串参数调用 XML API:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
其中:
XML_FILE_NAME
是您在第 2 步中创建的 XML 文件的路径。BUCKET_NAME
是相关存储桶的名称,例如my-bucket
。
检查存储桶的生命周期配置
控制台
- 在 Google Cloud 控制台中,进入 Cloud Storage 存储桶页面。
在存储桶列表中,您可以在生命周期列中看到每个存储桶的生命周期状态。
您可以点击此状态以添加、查看、修改和删除规则。
如需了解如何在 Google Cloud 控制台中获取失败的 Cloud Storage 操作的详细错误信息,请参阅问题排查。
命令行
使用带有 --format
标志的 gcloud storage buckets describe
命令:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(lifecycle_config)"
其中 BUCKET_NAME
是您要查看其生命周期配置的存储桶的名称,例如 my-bucket
。
客户端库
C++
如需了解详情,请参阅 Cloud Storage C++ API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
C#
如需了解详情,请参阅 Cloud Storage C# API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
如需查看存储桶的生命周期政策,请按照显示存储桶的元数据的说明操作,并在响应中查找生命周期政策字段。Go
如需了解详情,请参阅 Cloud Storage Go API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
如需查看存储桶的生命周期政策,请按照显示存储桶的元数据的说明操作,并在响应中查找生命周期政策字段。Java
如需了解详情,请参阅 Cloud Storage Java API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
如需查看存储桶的生命周期政策,请按照显示存储桶的元数据的说明操作,并在响应中查找生命周期政策字段。Node.js
如需了解详情,请参阅 Cloud Storage Node.js API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
如需查看存储桶的生命周期政策,请按照显示存储桶的元数据的说明操作,并在响应中查找生命周期政策字段。PHP
如需了解详情,请参阅 Cloud Storage PHP API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
如需查看存储桶的生命周期政策,请按照显示存储桶的元数据的说明操作,并在响应中查找生命周期政策字段。Python
如需了解详情,请参阅 Cloud Storage Python API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
如需查看存储桶的生命周期政策,请按照显示存储桶的元数据的说明操作,并在响应中查找生命周期政策字段。Ruby
如需了解详情,请参阅 Cloud Storage Ruby API 参考文档。
如需向 Cloud Storage 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为客户端库设置身份验证。
如需查看存储桶的生命周期政策,请按照显示存储桶的元数据的说明操作,并在响应中查找生命周期政策字段。REST API
JSON API
安装并初始化 gcloud CLI,以便为
Authorization
标头生成访问令牌。使用
cURL
通过GET
Bucket 请求调用 JSON API:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
其中
BUCKET_NAME
是相关存储桶的名称,例如my-bucket
。
XML API
安装并初始化 gcloud CLI,以便为
Authorization
标头生成访问令牌。使用
cURL
,通过GET
Bucket 请求和lifecycle
查询字符串参数调用 XML API:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
其中
BUCKET_NAME
是相关存储桶的名称,例如my-bucket
。