全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

CLEAR Object

最近更新时间: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。

  • 类型:String

  • 条件:无

注:可通过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和拥有ks3:ClearObject权限的用户删除回收站内文件。

No Content

204

回收站中不存在该Object

NoSuchBucket

404

该Bucket不存在

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈