You need to enable JavaScript to run this app.
导航

DeleteObject

最近更新时间2023.11.21 10:22:21

首次发布时间2021.10.13 16:14:07

功能描述

此接口用于删除桶中指定的对象。
当桶的多版本状态是开启时,调用此接口如果不指定版本删除,不会删除对象,将会产生一个新的版本号,并插入删除标记(DeleteMarker);当桶的多版本状态是 Suspended 时,删除版本为null的对象,并产生一个版本为 null 的删除标记。多版本状态下,指定版本删除将删除指定版本号的对象。

请求消息样式

DELETE /ObjectName HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string

请求参数和消息头

该请求使用公共请求消息头,请参见公共参数

名称

位置

参数类型

是否必选

示例值

说明

versionId

Query

String

123

待删除对象的版本号。

请求元素

该请求不使用消息元素。

响应消息头

该请求返回的公共响应消息头,请参见公共参数

名称

参数类型

说明

x-tos-delete-marker

Bool

标识对象是否标记删除。如果不是,则响应中不会出现该消息头。

x-tos-version-id

String

对象的版本号。如果该对象无版本号,则响应中不会出现该消息头。

响应元素

该请求响应中无消息元素。

请求示例

DELETE /objectName HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 GMT
Authorization: authorization string

响应示例

HTTP/1.1 204 No Content
Date: Fri, 30 Jul 2021 08:05:36 GMT
Server: TosServer
x-tos-id-2: 1e89f203b2d00006-a444ed0
x-tos-request-id: 1e89f203b2d00006-a444ed0