GetBucketObjectLock
更新时间 2026-04-10 20:09:08
最近更新时间: 2026-04-10 20:09:08
功能说明
GetBucketObjectLock请求获取存储桶的对象锁定配置。对象锁定功能将会应用到每一个新放入到存储桶中的对象。
请求消息样式
GET /{Bucket}?object-lock HTTP/1.1
Host: xxxx.zos.ctyun.cn
Accept-Encoding: identity
X-Amz-Content-SHA256: Content-SHA256
Authorization: string
X-Amz-Date: 20220407T022928Z请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释： 桶的名称。 | String | 是 |
请求消息头
该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。
请求消息元素
该请求消息中不带消息元素。
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: tx00000000000000000000f-00624e4c89-5e72-default
Content-Type: application/xml
Content-Length: 222
Date: Thu, 07 Apr 2022 02:29:45 GMT
Connection: Keep-Alive
<?xml version="1.0" encoding="UTF-8"?>
<ObjectLockConfiguration>
<ObjectLockEnabled>string</ObjectLockEnabled>
<Rule>
<DefaultRetention>
<Days>integer</Days>
<Mode>string</Mode>
<Years>integer</Years>
</DefaultRetention>
</Rule>
</ObjectLockConfiguration>响应消息头
该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。
响应消息元素
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| ObjectLockConfiguration | 参数解释： 桶的名称。 | Container |
表ObjectLockConfiguration
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| ObjectLockEnabled | 参数解释： 指定桶的对象锁定功能是否生效。 | String |
| Rule | 参数解释： 对象锁定规则。 | Container |
表Rule
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| DefaultRetention | 参数解释： 对象锁定规则中指定的默认配置。 | Container |
表DefaultRetention
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| Mode | 参数解释： 对象锁定规则中指定的默认保留期限模式。 取值范围： -GOVERNANCE：监管模式 -COMPLIANCE：合规性模式 | String |
| Days | 参数解释： 保留期限日期，单位：天。与Years设置只能二选一。 | Long |
| Years | 参数解释： 保留期限日期，单位：年。与Days设置只能二选一。 | Long |
