3.4.4. S3 put 对象锁定


put 对象锁定 API 将锁定配置放在所选存储桶中。使用对象锁定时,您可以使用 Write-Once-Read-Many (WORM)模型存储对象。对象锁定可确保,在一个固定的时间端内或无限期内,对象不会被删除或被覆盖。对象锁定配置中指定的规则默认应用于所选存储桶中放置的每个新对象。

重要

除非创建存储桶时启用对象锁定,否则操作会失败。

语法

PUT /BUCKET?object-lock HTTP/1.1

示例

PUT /testbucket?object-lock HTTP/1.1

请求实体

ObjectLockConfiguration
描述
用于请求的容器。
Type
Container
必填
ObjectLockEnabled
描述
指明此存储桶是否启用了对象锁定配置。
Type
字符串
必填
规则
描述
指定存储桶的对象锁定规则。
Type
Container
必填
DefaultRetention
描述
应用到指定存储桶中的新对象的默认保留周期。
Type
Container
必填
模式
描述
默认对象锁定保留模式。有效值:GOVERNANCE/COMPLIANCE。
Type
Container
必填
Days
描述
为默认保留周期指定的天数。
Type
整数
必填
Years
描述
为默认保留周期指定的年数。
Type
整数
必填

HTTP 响应

400
状态代码
MalformedXML
描述
XML 的格式不正确。
409
状态代码
InvalidBucketState
描述
没有启用存储桶对象锁定。
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

关于红帽文档

Legal Notice

Theme

© 2026 Red Hat
返回顶部