You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

DeleteObjectTagging

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

首次发布时间：2023.04.13 14:38:29

我的收藏

功能描述

调用 DeleteObjectTagging 接口删除指定对象（Object）的标签（Tag）信息。

版本控制

如果您的存储桶开启了版本控制功能，调用 DeleteObjectTagging 接口时，存在以下限制：

  • 默认情况下，该接口将直接删除当前版本对象的标签信息。您可以通过 versionId 参数，删除指定对象版本的标签信息。
  • 如果对象的版本具有删除标记（Delete Marker），您将无法删除指定对象的标签信息，TOS 将返回 404 Not Found。

请求消息样式

DELETE /objectname?tagging
Host: Host: examplebucket.tos.cn-beijing.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue

请求参数和消息头

使用公共请求消息头。更多信息，请参见公共参数。

参数名称

位置

参数类型

是否必选

示例值

说明

tagging

Query

String

是

/

只需设置参数名称，无需设置参数值，代表 DeleteObjectTagging 请求的特殊标识。

versionId

Query

String

否

578946D81EB06437B793

对象的版本号，用于标识删除指定版本的对象标签。

请求元素

该请求无请求消息元素。

响应消息头

返回公共响应消息头。更多信息，请参见公共参数。

响应元素

该请求响应无消息元素。

请求示例

  • 删除对象标签
DELETE /objectname?tagging
Host: bucketname.tos.cn-beijing.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue
  • 删除指定版本的对象标签
DELETE /objectname?tagging&versionId=578946D81EB06437B793
Host: bucketname.tos.cn-beijing.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue

返回示例

  • 删除对象标签后返回示例
HTTP/1.1 200 OK
server: TosServer
date: Wed, 24 Jun 2020 08:58:15 GMT
x-tos-id-2: 1e89f203jld00006-a444fd0
x-tos-request-id: 1e89f203b2d00006-a444ed0
  • 删除指定版本的对象标签后返回示例
HTTP/1.1 200 OK
server: TosServer
date: Wed, 24 Jun 2020 08:58:15 GMT
x-tos-id-2: 1e89f203jld00006-a444fd0
x-tos-request-id: 1e89f203b2d00006-a444ed0
x-tos-version-id: 578946D81EB06437B793