最近更新时间:2024-04-22 11:10:55
该接口用于删除Bucket回收站中的Object(对象),使用此接口的用户,必须是该Bucket的所有者或具有ks3:ClearObject
权限。
DELETE /{ObjectKey}?clear HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
x-kss-retention-id: {ObjectRetentionId}
该接口不使用请求参数。
除公共请求头外,该接口还需要以下请求头:
名称 | 描述 | 是否必选 |
x-kss-retention-id | 指定被删除Object的删除ID。
| 是 |
注:可通过LIST Retention接口查看响应参数RetentionId获取回收站内文件的删除ID。
该接口不使用请求体。
该接口仅返回公共响应头。
该接口不返回响应体。
POST /object-name?clear HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyu ncs.com
Date: Fri, 26 Dec 2023 06:38:43 GMT
Authorization: authorization string
x-kss-retention-id: 29822733972333_MjcxMzAwMDAwMDAwMDAwQThDM0EwMDAwMDAwMDAwNDA****
HTTP/1.1 204 No Content
Date: Fri, 26 Dec 2014 06:52:15 GMT
Content-Length: 0
Connection: keep-alive
x-kss-request-id: f87det80n87obs77t98qvnorlk24****
Server: KS3
错误码 | HTTP状态码 | 描述 |
AccessDenied | 403 | 没有操作权限。仅支持Bucket Owner和拥有 |
No Content | 204 | 回收站中不存在该Object |
NoSuchBucket | 404 | 该Bucket不存在 |
纯净模式