DeleteObjectTagging

版本控制

调用DeleteObjectTagging接口时，默认只能删除Object当前版本的标签信息。您可以通过指定versionId参数来删除指定Object版本的标签信息。如果Object的对应版本为删除标记（Delete Marker），则OSS将返回404 Not Found。

请求语法

DELETE /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue

当您在OSS ON云盒中调用该接口时，您需要将Host替换为云盒Endpoint。更多信息，请参见云盒Endpoint。

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

示例

• 未开启版本控制

  在未开启版本控制的情况下，通过DELETE请求删除了存储空间bucketname中对象objectname已有的标签信息，OSS解析此请求后删除此对象中的所有标签。

  请求示例

  DELETE /objectname?tagging
  Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 03:00:33 GMT
  Authorization: OSS qn6q**************:77Dv****************

  返回示例

  204 (No Content)
  content‐length: 0
  server: AliyunOSS
  x‐oss‐request‐id: 5CAC0AD16D0232E2051B****
  date: Tue, 09 Apr 2019 03:00:33 GMT

• 已启用版本控制

  在启用版本控制的情况下，通过DELETE请求删除存储空间bucketname中对象objectname已有的标签信息，删除时指定了对象版本号（即请求示例中的versionId），OSS解析此请求后删除此版本对象中的所有标签。

  请求示例

  DELETE /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
  Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  Date: Wed, 24 Jun 2020 09:01:09 GMT
  Authorization: OSS qn6q**************:77Dv****************

  返回示例

  204 (No Content)
  content-length: 0
  server: AliyunOSS
  x-oss-request-id: 5EF3165525D95C3338E8****
  date: Wed, 24 Jun 2020 09:01:09 GMT
  x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****

SDK

DeleteObjectTagging接口对应的各语言SDK示例如下：

• Java

• Python

• Go V2

• PHP

• C++

• .NET

• Node.js

• iOS

命令行工具ossutil

DeleteObjectTagging接口所对应的ossutil命令，请参见delete-object-tagging。