文档首页

当版本控制为启用时，该 DELETE 操作将创建一个删除标记作为指定对象的最新版本，此时响应将返回 x-cos-version-id 响应头部，代表该请求操作创建的删除标记的版本 ID。
当版本控制为暂停时，该 DELETE 操作将创建一个版本 ID 为 null 的删除标记作为指定对象的最新版本，同时删除任何已存在的版本 ID 为 null 的其他版本（如有）。

当该 DELETE 操作创建或删除了删除标记，那么将返回 x-cos-delete-marker: true 响应头部，代表该 DELETE 操作创建或删除了指定对象的删除标记。

有关版本控制的启用或暂停状态说明，请参见版本控制概述。

请求

语法示例：

DELETE /ObjectName HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: GMT Date
Content-Length: length
Authorization: Auth String

说明：

Authorization: Auth String (详细参见请求签名章节)。

请求行

DELETE /ObjectName HTTP/1.1

该 API 接口接受 DELETE 请求。

请求参数

名称	描述	类型	是否必选
versionId	指定要删除的版本 ID	string	否

请求头

公共头部

该请求操作的实现使用公共请求头,了解公共请求头详细请参见公共请求头部章节。

非公共头部

该请求操作无特殊的请求头部信息。

请求体

该请求的请求体空。

响应

响应头

公共响应头

该响应使用公共响应头,了解公共响应头详细请参见公共响应头部章节。

特有响应头

该请求操作无特殊的响应头。

版本控制相关头部

删除启用版本控制的存储桶内的对象或对象的指定版本将返回下列响应头部：

名称	描述	类型
x-cos-version-id	对象的版本 ID 或删除标记的版本 ID	string
x-cos-delete-marker	当使用 versionId 请求参数指定删除标记的版本 ID 时，将返回此响应头部且值为 true，代表删除的版本 ID 对应的是一个删除标记当未使用 versionId 请求参数，且指定对象所在的存储桶启用了版本控制时，将返回此响应头部且值为 true，代表该删除请求创建了一个删除标记作为对象的最新版本	boolean

响应体

该请求的响应体为空。

错误分析

以下描述此请求可能会发生的一些特殊的且常见的错误情况：

错误码	HTTP状态码	描述
NoSuchBucket	404 Not Found	Bucket 不存在

获取更多关于COS的错误码的信息，或者产品所有的错误列表，请查看错误码文档。

实际案例

请求

DELETE /123 HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: Wed, 23 Oct 2016 21:32:00 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&q-sign-time=1484213409;32557109409&q-key-time=1484213409;32557109409&q-header-list=host&q-url-param-list=&q-signature=1c24fe260ffe79b8603f932c4e916a6cbb0af44a

响应

HTTP/1.1 204 No Content
Content-Type: application/xml
Content-Length: 0
Connection: keep-alive
Date: Wed, 23 Oct 2016 21:32:00 GMT
x-cos-request-id: NTg3NzRjYTRfYmRjMzVfMzFhOF82MmM3Yg==