用于为 Bucket 设置、修改或删除对象版本锁的默认配置。若设置了 Bucket 的对象版本锁的默认配置，则后续上传的对象，均会携带该默认配置。

说明

  • Bucket 开启对象版本锁的同时会开启多版本功能。

  • 该 API 操作的是 Bucket 的对象版本锁的默认配置。生效范围为后续上传的对象。

请求语法

PUT /?object-lock HTTP/1.1
Host: mybucket.pek3b.qingstor.com
Date: Sun, 16 Aug 2015 09:05:00 GMT
Authorization: authorization string
Content-MD5: string

{
    "status": "Enabled"
    "mode": "GOVERNANCE",
    "days": integer,
    "years": integer,
}

请求参数

无。

请求头

此接口仅包含公共请求头。关于公共请求头的更多信息，请参见公共请求头。

请求消息体

调用该 API 需携带如请求语法中的 Json 消息体。该消息体各字段说明如下。

名称 类型 说明 是否必须

status

String

对象版本锁状态，要求必须是 Enabled

是

mode

String

对象版本锁的保护模式。取值为 GOVERNANCE 或 COMPLIANCE。用户可参考前文说明进行选择。

是

days

Integer

数据保留时间，最大限制为 36500 天。

否

years

Integer

数据保留时间，最大限制为 100 年。

否
说明

days 与 years 只能配置一种，不能同时存在。

响应头

此接口仅包含公共响应头。关于公共响应头的更多信息，请参见公共响应头。

响应体

无。

示例

示例一

仅开启对象版本锁，不配置默认规则。此时，系统会生成一条默认规则。

{
    mode: GOVERNANCE,
    time: u32,
    hold: bool,
}

  • 请求消息

    PUT /?object-lock HTTP/1.1
Host: mybucket.pek3b.qingstor.com
Date: Sun, 16 Aug 2015 09:05:00 GMT
Authorization: authorization string
Content-MD5: string

{
    "status": "Enabled"
}

  • 响应示例

    HTTP/1.1 200 OK
Server: QingStor
Date: Sun, 16 Aug 2015 09:05:00 GMT
Content-Length: 809
Connection: close
x-qs-request-id: aa08cf7a43f611e5886952542e6ce14b

示例二

开启对象版本锁，并设置默认规则或修改默认规则。后续上传的对象，均携带该对象版本锁信息。

  • 请求消息

    PUT /?object-lock HTTP/1.1
Host: mybucket.pek3b.qingstor.com
Date: Sun, 16 Aug 2015 09:05:00 GMT
Authorization: authorization string
Content-MD5: string

{
    "status": "Enabled"
    "mode": "GOVERNANCE",
    "days": 1,
}

  • 响应示例

    HTTP/1.1 200 OK
Server: QingStor
Date: Sun, 16 Aug 2015 09:05:00 GMT
Content-Length: 809
Connection: close
x-qs-request-id: aa08cf7a43f611e5886952542e6ce14b

示例三

删除默认配置规则，但是不能关闭对象版本锁功能。此时，系统会生成一条默认规则。

  • 请求消息

    PUT /?object-lock HTTP/1.1
Host: mybucket.pek3b.qingstor.com
Date: Sun, 16 Aug 2015 09:05:00 GMT
Authorization: authorization string
Content-MD5: string

{
    "status": "Enabled"
}

  • 响应示例

    HTTP/1.1 200 OK
Server: QingStor
Date: Sun, 16 Aug 2015 09:05:00 GMT
Content-Length: 809
Connection: close
x-qs-request-id: aa08cf7a43f611e5886952542e6ce14b