全部文档
当前文档
最近更新时间：2024-02-21 17:53:59
该接口用于获取Bucket回收站配置规则，使用此接口的用户，必须是该Bucket的所有者或具有ks3:GetBucketRetention权限。
GET /?retention HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}该接口不使用请求参数。
该接口仅使用公共请求头。
该接口不使用请求体。
该接口仅返回公共响应头。
响应体为一段描述回收站规则（RetentionConfiguration）的XML，响应体中包含的元素有：
名称 | 描述 |
|---|---|
RetentionConfiguration | 包含回收站规则的容器。
|
Rule | 包含一条回收站具体规则的容器。
|
Status | 回收站的开启状态。
|
Days | 表示Object进入回收站多少天后彻底删除。
|
GET /?retention HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Fri, 26 Dec 2023 06:38:43 GMT
Authorization: authorization stringHTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 312
Date: Fri, 26 Dec 2023 06:38:43 GMT
Server: KS3
x-kss-request-id: 54a47bda18ac4e6e91de369add54218e
<RetentionConfiguration>
<Rule>
<Status>Enabled</Status>
<Days>90</Days>
</Rule>
</RetentionConfiguration>错误码(code) | HTTP状态码 | 描述 |
|---|---|---|
AccessDenied | 403 | 没有操作权限。仅支持Bucket Owner和拥有 |
NoSuchBucket | 404 | 不存在该Bucket |
纯净模式