若对于新上传的对象,不使用默认的对象版本锁配置,则可在上传对象时,设置其对象版本锁信息。

新增请求头

对象版本锁的设置,除公共请求头以外,还包含以下请求头字段。

头字段 类型 说明

x-qs-object-lock-retain-until-date

Date

用于指定对象版本锁保护截止时间。

x-qs-object-lock-mode

String

用于指定对象版本锁的模式。

x-qs-object-lock-legal-hold

Bool

用于指定对象版本锁是否持有。true 为被持有状态,该状态下,对象不能被删除。

说明
  • x-qs-object-lock-retain-until-datex-qs-object-lock-mode 需同时设置。

  • x-qs-object-lock-legal-hold 可单独设置。

请求示例

示例一

PUT /myphoto.jpg HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2022 09:05:00 GMT
Content-Length: 7987
x-qs-object-lock-retain-until-date: 2023-04-01T00:00:00Z
x-qs-object-lock-mode: GOVERNANCE
x-qs-object-lock-legal-hold: true
Authorization: authorization string

示例二

PUT /myphoto.jpg HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2022 09:05:00 GMT
Content-Length: 7987
x-qs-object-lock-legal-hold: true
Authorization: authorization string