此接口用于删除桶中指定的对象。
当桶的多版本状态是开启时,调用此接口如果不指定版本删除,不会删除对象,将会产生一个新的版本号,并插入删除标记(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 | 否 | 5840E600C6FBD446792D | 待删除对象的版本号。 |
该请求不使用消息元素。
该请求返回的公共响应消息头,请参见公共参数。
名称 | 参数类型 | 示例值 | 说明 |
---|---|---|---|
x-tos-delete-marker | Bool | true | 标识对象是否标记删除。如果不是,则响应中不会出现该消息头。 |
x-tos-version-id | String | 5840E600C6FBD446792D | 对象的版本号。如果该对象无版本号,则响应中不会出现该消息头。 |
该请求响应中无消息元素。
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