全部文档
当前文档
最近更新时间：2024-02-21 17:53:59
该接口用于开通、关闭及设置Bucket回收站功能，使用此接口用户，必须是该Bucket的所有者或具有ks3:PutBucketRetention权限。
注：有关回收站规则描述的更多细节，请参见文档：回收站。
PUT /?retention HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
Content-length: {length}
Content-MD5: {md5} 该接口不使用请求参数。
除公共请求头外，该接口还需要以下请求头：
名称 | 描述 | 是否必选 |
|---|---|---|
Content-MD5 | Body里Data的128位MD5 Digest，再用Base64编码。该请求头用于数据完整性校验，检查Body是否损坏。详见RFC-1864
| 是 |
请求体为一段描述回收站规则（RetentionConfiguration）的XML，请求体中包含的元素有：
名称 | 描述 | 是否必填 |
|---|---|---|
RetentionConfiguration | 包含回收站规则的容器。
| 是 |
Rule | 包含一条回收站具体规则的容器。
| 是 |
Status | 回收站的开启状态，不区分大小写。
| 是 |
Days | 指定Object进入回收站多少天后彻底删除。当不设置Days时，Object删除后将在回收站中永远保留。
| 否 |
该接口仅返回公共响应头。
该接口不返回响应体。
PUT /?retention HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyun.com
Date: Wed, 14 May 2021 02:11:21 GMT
Content-MD5: 3A2M2Y4AsgTpgAmY8PhC****
Authorization: authorization string
Content-Length: 1000
Content-type: application/xml
<RetentionConfiguration>
<Rule>
<Status>Enabled</Status>
<Days>90</Days>
</Rule>
</RetentionConfiguration>HTTP/1.1 200 OK
Content-Length: 1000
Date: Fri, 26 Dec 2023 06:38:43 GMT
x-kss-request-id: 64a47bda18ac4e6e91de369add54218e
Server: KS3注：如使用AWS签名，将同时返回
x-amz-request-id和x-kss-request-id。
错误码 | HTTP状态码 | 描述 |
|---|---|---|
MalformedXML | 400 | 未填写必填项（XML格式不合法）。 |
InvalidArgument | 400 | 设置回收站规则时，删除时间Days不正确，不是1-365的正整数。 |
AccessDenied | 403 | 没有操作权限。仅支持Bucket Owner和拥有 |
NoSuchBucket | 404 | 指定设置回收站的Bucket不存在。 |
纯净模式