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 - 描述
- 没有启用存储桶对象锁定。