S3 放置对象保留时间

在线编辑

放置对象保留时间 API 将对象保留时间配置放在对象上。 保留期会在固定时间内保护对象版本。 有两种模式: 监管模式和合规模式。 这两种保留方式对您的对象应用不同级别的保护。

注: 在此期间，您的对象是 write-once-read-many(受 WORM 保护) ，不能被覆盖或删除。

语法

PUT /BUCKET/OBJECT?retention&versionId= HTTP/1.1

示例

PUT /testbucket/testobject?retention&versionId= HTTP/1.1

versionId 子资源检索对象的特定版本。

请求实体

Retention

描述

请求的容器。

类型

容器

必需

是

Mode

描述

指定对象的保留方式。 有效值:GOVERNANCE/合规性

类型

字符串

必需

是

RetainUntilDate

描述

保留日期。 格式: 2020-01-05T00:00:00.000Z

类型

时间戳记

必需

是