## **功能描述** 此接口用于获取桶的保留策略。 ## **请求消息样式** ```JSON GET /?object-lock HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string ``` ## **请求参数和消息头** 该请求使用的公共消息头，请参见[公共参数](/docs/6349/75044)。 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |object\-lock |Query |String |是 |\- |代表 GetBucketObjectLockConfiguration 请求的特殊标识。 | ## **请求元素** 该请求不使用消息元素。 ## **响应消息头** 该请求返回公共响应消息头。 ## **响应元素** |**名称** |**参数类型** |**示例值** |**说明** | |---|---|---|---| |ObjectLockEnabled |String |Enabled |是否开启保留策略，取值仅为 `Enabled`，表示开启保留策略。 | |Rule |Object |\- |桶保留策略规则。 | |DefaultRetention |Object |\- |桶的默认保留策略。|\ | | | |父节点： Rule。 | |Days |Integer |1 |对象锁定天数，在指定天数内对象不能被删除或覆盖，以天为单位。|\ | | | |父节点：DefaultRetention | |Years |Integer |1 |对象锁定年数，在指定年数内对象不能被删除或覆盖，以年为单位，一年为 365 天。|\ | | | |父节点：DefaultRetention | |Mode |String |COMPLIANCE |保留策略模式，取值仅为 `COMPLIANCE`，表示合规模式，即任何用户在保留期内均不能删除或覆盖被锁定的对象。|\ | | | |父节点：DefaultRetention | ## **请求示例 1** ```JSON GET /?object-lock HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 13:59:18 GMT Authorization: authorization string ``` ## **响应示例 1** ```JSON HTTP/1.1 200 OK x-tos-id-2: f91b0c03a01300c1-a444ed0 x-tos-request-id: f91b0c03a01300c1-a444ed0 Date: Fri, 30 Jul 2021 06:45:39 GMT server: TosServer Content-Length: 31 { "ObjectLockEnabled": "Enabled" } ``` ## **请求示例 2** ```JSON GET /?object-lock HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 13:59:18 GMT Authorization: authorization string ``` ## **响应示例 2** ```JSON HTTP/1.1 200 OK x-tos-id-2: f91b0c03a01300c1-a444ed0 x-tos-request-id: f91b0c03a01300c1-a444ed0 Date: Fri, 30 Jul 2021 06:45:39 GMT server: TosServer Content-Length: 92 { "ObjectLockEnabled": "Enabled", "Rule": { "DefaultRetention": { "Days": 100, "Mode": "COMPLIANCE" } } } ```

对象存储