设置对象标签-九游平台

功能介绍

用户可以通过本接口设置或更新对象（object）的标签信息。对象标签使用一组键值对（key-value）标记对象。

如果请求中不携带版本号（versionid），需要确保执行者有putobjecttagging权限。如果请求中携带版本号（versionid），需要确保执行者有putobjecttagging putobjectversiontagging权限。缺省情况下只有对象的所有者可以执行此操作，也可以通过设置桶策略或用户策略给其他用户。

默认设置object当前版本的标签信息。可以通过指定versionid参数来设置指定object版本的标签信息。如果对应版本为删除标记（delete marker），则obs将返回404 not found。

请求消息样式

put /objectname?tagging&versionid=versionid http/1.1
host: bucketname.obs.cn-north-4.myhuaweicloud.com 
date: date
authorization: authorization string
content-md5: md5


    
        
            key
            value
        
      

请求消息参数

该请求使用的消息参数如下表1 请求消息参数所示。

请求消息头

该请求使用的消息头如下表2 请求消息头所示。

请求消息元素

在此请求中，需要在请求的消息体中配置对象的标签。标签的配置信息以xml格式上传。具体的配置元素如下表3 对象的标签配置元素所示。

响应消息样式

1
2
3
4
5

http/1.1status_code
x-obs-request-id:requestid
x-obs-id-2:id
content-length:length
date:date

响应消息头

该请求的响应消息使用公共消息头，具体请参考3.3-表 公共响应消息头。

响应消息元素

该请求的响应消息中不带有响应元素。

错误响应消息

除了公共的错误码外，此接口还会返回一些其他的错误码。下表中列出本接口的一些常见错误，以及可能原因。如下表4 配置对象标签错误码列表。

请求示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

put/objectname?tagging&versionid=g001018455096ce600005306000000ddhttp/1.1
user-agent:curl/7.29.0
host:examplebucket.obs.cn-north-4.myhuaweicloud.com
accept:*/*
date:wed,27jun201813:22:50gmt
authorization:obsh4ipjx0tqththebqqcec:pf1zygvvyg2bzojokz/baer1meq=
content-md5:mnaevkfqignbpchoe2u6og==
content-length:182
xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/">


tagname1
tagesetvaule1

响应示例

1
2
3
4
5

http/1.1200ok
server:obs
x-obs-request-id:bf26000001643feba09b1ed46932cd07
x-obs-id-2:32aaaqaaeaabsaagaaeaabaaaqaaeaabcsezp87ieirc6dggpb5cn49psvhbwclg
date:wed,27jun201813:22:50gmt