# 删除对象标签-DeleteObjectTagging
#### 功能介绍
可通过本接口删除对象的标签信息。了解更多对象标签相关信息，请参考[对象标签](https://support.huaweicloud.com/usermanual-obs/obs_41_0054.html)。
#### 授权信息
您必须是对象拥有者或拥有删除对象标签的权限，才能调用本接口，建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见[OBS不同权限控制方式的区别](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0001.html)。
- 如果使用**IAM授权** ，那么请在"角色与策略授权"、"身份策略授权"两种IAM授权方式中选择一种，并配置相应权限：
  - 如果使用**角色与策略授权** （旧版IAM，即IAM v3接口），需具备**obs:object:DeleteObjectTagging** （未开启多版本）、**obs:object:DeleteObjectVersionTagging** （开启或暂停多版本）权限，授权操作请参见[创建IAM自定义策略](https://support.huaweicloud.com/usermanual-iam/iam_01_0605.html)。
  
  - 如果使用**身份策略授权** （新版IAM，即IAM v5接口），如下表所示，需具备**obs:object:deleteObjectTagging** （未开启多版本）、**obs:object:deleteObjectVersionTagging** （开启或暂停多版本）权限，授权操作请参见[创建IAM自定义身份策略](https://support.huaweicloud.com/usermanual-iam5/iam_01_0917.html)。
    
    | 授权项 Action                                                                              | 访问级别 Access Level | 资源类型（\*为必须） Resource Type (\*: required) | [条件键](https://support.huaweicloud.com/api-obs/obs_04_0112.html#ZH-CN_TOPIC_0000002375307974__condition_table) Condition Key                                                                                                                                                                                                                                                                                                                                                 | [别名](https://support.huaweicloud.com/iam5_faq/iam_01_1103.html) Alias | 依赖的授权项 Dependencies |
    |:---|:---|:---|:---|:---|:---|
    | obs:object:deleteObjectTagging（未开启多版本） obs:object:deleteObjectVersionTagging（开启或暂停多版本） | Tagging        | object \*                                                                              | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2)  - [g:ResourceTag/\<tag-key\>](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2)                                                         | -                                                               | -              |
    | obs:object:deleteObjectTagging（未开启多版本） obs:object:deleteObjectVersionTagging（开启或暂停多版本） | Tagging        | -                                                                                      | - obs:EpochTime  - obs:SourceIp  - obs:TlsVersion  - obs:CustomDomain   | -                                                               | -              |
       
    
   
- 如果使用**桶策略** 进行授权，需具备**obs:object:DeleteObjectTagging** （未开启多版本）、**obs:object:DeleteObjectVersionTagging** （开启或暂停多版本）权限，具体操作请参见[自定义创建桶策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0123.html)。
 
#### URI
DELETE /{*object_key*}?tagging
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-obs/obs_04_0006.html)。调用前需要先[计算API签名](https://support.huaweicloud.com/api-obs/obs_04_0009.html)，并将签名添加到请求中。
您还可以使用[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/OBS/doc?api=DeleteObjectTagging)在线调试接口。
#### 请求消息样式
```
DELETE /objectname?tagging&versionId=versionid  HTTP/1.1  
Host: bucketname.obs.cn-north-4.myhuaweicloud.com 
Date: date
Authorization: authorization string
```
#### URI参数（URI Parameters）
该请求使用的消息参数如下[表1]所示。
 表1URI参数 
| **参数名称**  | **是否必选** | 类型     | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| tagging   | 是        | String | **参数解释：** 标识当前请求是对象标签请求。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                                                                                                             |
| versionId | 否        | String | **参数解释：** 对象版本号。标识删除指定版本的对象标签。对应的响应头 (Response Headers)为x-obs-version-id。如果对应版本为删除标记（Delete Marker），则OBS将返回404 Not Found。 **约束限制**： 不涉及。 **取值范围：** 长度为32的版本ID字符串。 **默认取值：** 不涉及。 |
   
#### 请求头参数（Request headers）
该请求使用公共请求头，具体参见[表3](https://support.huaweicloud.com/api-obs/obs_04_0007.html#ZH-CN_TOPIC_0136436606__table25197309)。
#### 请求体参数（Request body）
该请求消息中不带请求体参数。
#### 响应消息样式
```
HTTP/1.1 status_code
x-obs-request-id: request id
x-obs-id-2: id
x-obs-version-id: version id
Content-Length: length
Date: date
```
#### 响应头 (Response Headers)
该请求的响应消息使用公共响应头，具体请参考[表1](https://support.huaweicloud.com/api-obs/obs_04_0013.html#ZH-CN_TOPIC_0173612084__d0e686)。
#### 响应体 (Response Body)
该请求的响应消息中不带消息元素。
#### 错误响应消息
无特殊错误，所有错误已经包含在[错误码概述](https://support.huaweicloud.com/api-obs/obs_04_0115.html)。对象未设置标签或删除标签成功时返回204。
#### 请求示例
```
DELETE /objectname?tagging&versionId=G001018455096CE600005306000000DD HTTP/1.1   
User-Agent: curl/7.19.7    
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*   
Date: Wed, 27 Jun 2018 13:46:58 GMT   
Authorization: authorization string
```
#### 响应示例
```
HTTP/1.1 204 No Content 
x-obs-request-id: 0002B7532E0000015BEB2C212E53A17L 
x-obs-id-2: CqT+86nnOkB+Cv9KZoVgZ28pSgMF+uGQBUC68flvkQeq6CxoCz65wWFMNBpXvea4 
x-obs-version-id: G001018455096CE600005306000000DD
Content-Length: 0
Date: Wed, 27 Jun 2018 13:46:58 GMT
```
#### 使用SDK调用接口
建议您使用OBS SDK调用接口。SDK对API进行了封装以简化您的开发工作，直接调用SDK接口函数即可访问OBS，无需手动计算签名。
| [Java](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2311.html) | Python暂不支持 | C暂不支持 | Go暂不支持 | BrowserJS暂不支持 | .NET暂不支持 | Android暂不支持 | iOS暂不支持 | Node.js暂不支持 |
|---|---|---|---|---|---|---|---|---|
   
#### 相关文档
- 了解更多对象标签相关介绍，请参见[对象标签](https://support.huaweicloud.com/usermanual-obs/obs_41_0054.html)。
- API操作涉及的计费项参见[计费项](https://support.huaweicloud.com/price-obs/obs_42_0002.html)。