全部文档
当前文档
最近更新时间：2026-01-06 15:34:32
此接口主要实现删除对象操作（如果存在）。使用此接口的用户，必须是该Bucket的所有者或具有ks3:DeleteObject权限。
1. 若未开通回收站功能，文件删除后无法恢复，请谨慎操作。建议开启回收站功能。
2. 若文件存在，删除成功后返回204状态码，若文件不存在，将返回404状态码。
3. 如果需要自动删除文件，请参见生命周期管理。
DELETE /{ObjectKey} HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Content-Length: {length}
Authorization: {SignatureValue}该请求不使用请求参数。
该接口除了使用所有公共请求头外，还可以使用以下请求头。
名称 | 描述 | 是否必选 |
|---|---|---|
if-match | 控制删除行为的ETag条件，只有当指定的ETag与存储桶中已有对象的ETag匹配时，才会删除对象。若指定的ETag不存在或不匹配，则删除对象会失败，并返回412状态码。多个ETag用英文逗号分隔，该场景任意一个匹配成功即可删除文件成功。
| 否 |
该接口返回常用响应头部。获取更多信息，请点击常用响应头部。
该接口不返回响应内容。
DELETE /my-image.jpg HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyun.com
Date: Fri, 26 Dec 2014 06:52:15 GMT
If-Match: 1b2cf535f27731c974343645a398****
Authorization: authorization string
Content-Type: text/plainHTTP/1.1 204 No Content
Date: Fri, 26 Dec 2014 06:52:15 GMT
Content-Length: 0
Connection: keep-alive
x-kss-request-id: f87det80n87obs77t98qvnorlk2415v9
Server: KS3HTTP状态码 | 错误码 | 描述 |
|---|---|---|
404 Not Found | NoSuchKey | 不存在该文件。 |
当遇到网络断开或网络超时等异常情况，可能文件已经删除成功但客户未接收到成功响应，重试删除操作时由于文件已不存在导致删除失败，该情况下建议先通过HEAD Object确认文件存在后再进行重试删除操作。
纯净模式