全部文档
当前文档
最近更新时间：2024-04-03 17:42:07
该接口用于恢复Bucket回收站中的Object（对象），使用此接口的用户，必须是该Bucket的所有者或具有ks3:RecoverObject权限。
POST /{ObjectKey}?recover HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}该接口不使用请求参数。
除公共请求头外，该接口还需要以下请求头：
名称 | 描述 | 是否必选 |
|---|---|---|
x-kss-retention-overwrite | 从回收站内被恢复的Object在Bucket中存在同名Object时，是否支持覆盖。当取值为true时表示覆盖，Bucket内被覆盖的Object会进入回收站。
| 否 |
x-kss-retention-id | 指定被恢复Object的删除ID。当不带该请求头时，默认只恢复最新的一个版本。
| 否 |
该接口不使用请求体。
该接口仅返回公共响应头。
该接口不返回响应体。
POST /object-name?recover HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Fri, 26 Dec 2023 06:38:43 GMT
x-kss-retention-overwrite: true
x-kss-retention-id: 29832406847475_MjcxMjAwMDAwMDAwMDAxNUFFNjUwMDAwMDAwMDAwNEY3N0I2
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: NTk5NDM5NWFfMjQ4OGY3Xzc3NGRf****错误码 | HTTP状态码 | 描述 |
|---|---|---|
AccessDenied | 403 | 拒绝访问 |
NoRetentionObject | 400 | 回收站中不存在该Object |
NoSuchBucket | 404 | 该Bucket不存在 |
纯净模式