PutObjectLegalHold
更新时间 2026-04-10 20:11:12
最近更新时间: 2026-04-10 20:11:12
功能说明
PutObjectLegalHold请求在指定对象上设置依法保留配置。
请求消息样式
PUT /{Bucket}/{Key}?legal-hold&versionId=VersionId HTTP/1.1
Host: xxx.zos.ctyun.cn
Accept-Encoding: identity
X-Amz-Content-SHA256: Content-SHA256
X-Amz-Date: 20220412T100505Z
Content-Length: 90
Content-MD5: erOisiAmIIzsh/Ze2QqGXw==
Authorization: string
<?xml version="1.0" encoding="UTF-8"?>
<LegalHold>
<Status>string</Status>
</LegalHold>请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释: Bucket的名称。 | String | 是 |
| Key | 参数解释: 对象名称。 | String | 是 |
| versionId | 参数解释: 对象的版本ID。 | String | 否 |
请求消息头
该请求使用公共的请求消息头,请参见如何调用API-构造请求-请求消息头。
请求消息元素
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| LegalHold | 参数解释: 指定对象依法保留配置。 | Container | 否 |
表LegalHold
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Status | 参数解释: 是否打开对象依法保留。 取值范围: -ON:打开 -OFF:关闭 | String | 否 |
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: tx00000000000000000000c-00624e4b61-5e72-default
Content-Length: 0
Date: Thu, 07 Apr 2022 02:24:50 GMT
Connection: Keep-Alive响应消息头
该请求的响应消息使用公共的响应消息头,请参见如何调用API-响应结果-响应消息头。
响应消息元素
该请求的响应中不带有响应元素。
错误码
请参见调用前必知-错误码-全局错误码。