九游平台/ 对象存储服务 obs/ api参考/ api/ 对象操作/ 获取对象标签
更新时间：2024-10-21 gmt 08:00
查看pdf

获取对象标签-九游平台

功能介绍

用户可以通过本接口获取对象（object）的标签信息。

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

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

并行文件系统不支持获取文件标签。

请求消息样式

1
2
3
4
 
get/objectname?tagging&versionid=versionidhttp/1.1
host:bucketname.obs.cn-north-4.myhuaweicloud.com
date:date
authorization:authorizationstring

请求消息参数

该请求消息中不使用消息参数。

请求消息头

该请求使用公共消息头，具体参见表3。

请求消息元素

此请求消息中不使用消息元素。

响应消息样式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
 
http/1.1status_code
x-obs-request-id:requestid
x-obs-id-2:id
x-obs-version-id:versionid
content-type:application/xml
content-length:length
date:date

xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/">


key
value

响应消息头

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

响应消息元素

在此请求返回的响应消息体中包含的配置元素，具体参见表3 对象的标签配置元素。

错误响应消息

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

表1 获取对象标签的错误码列表

错误码

描述

http状态码

nosuchtagset

指定的对象没有设置标签

404

请求示例

1
2
3
4
5
6
 
get/objectname?tagging&versionid=g001018455096ce600005306000000ddhttp/1.1
user-agent:curl/7.29.0
host:bucketname.obs.cn-north-4.myhuaweicloud.com
accept:*/*
date:wed,27jun201813:25:44gmt
authorization:obsh4ipjx0tqththebqqcec:h1incyc5i0xlhqytfuzkpxlzupm=

响应示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
 
http/1.1200ok
x-obs-request-id:0002b7532e0000015beb35330c5884x1
x-obs-id-2:s12w20lynqqsb7moq4ibgjwmqrsmvqv rfbqplogykxupxes/nombkyd e35k79j
x-obs-version-id:g001018455096ce600005306000000dd
content-type:application/xml
date:wed,27jun201813:25:44gmt
content-length:441

xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/">


tagname1
tagesetvaule1
父主题： 对象操作

相关文档

网站地图