更新时间：2024-10-21 GMT+08:00
获取对象标签
功能介绍
用户可以通过本接口获取对象（Object）的标签信息。
如果请求中不携带版本号（versionId），需要确保执行者有GetObjectTagging权限。如果请求中携带版本号（versionId），需要确保执行者有GetObjectTagging+GetObjectVersionTagging权限。缺省情况下只有对象的所有者可以执行此操作，也可以通过设置桶策略或用户策略给其他用户。
默认获取Object当前版本的标签信息。可以通过指定versionId参数来获取指定Object版本的标签信息。如果对应版本为删除标记（Delete Marker），则OBS将返回404 Not Found。
并行文件系统不支持获取文件标签。
请求消息样式
1 2 3 4 |
GET /objectname?tagging&versionId=versionid HTTP/1.1 Host: bucketname.obs.cn-north-4.myhuaweicloud.com Date: date Authorization: authorization string |
请求消息参数
该请求消息中不使用消息参数。
请求消息头
该请求使用公共消息头，具体参见表3。
请求消息元素
此请求消息中不使用消息元素。
响应消息样式
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
HTTP/1.1 status_code x-obs-request-id: request id x-obs-id-2: id x-obs-version-id: version id Content-Type: application/xml Content-Length: length Date: date <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Tagging xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/"> <TagSet> <Tag> <Key>key</Key> <Value>value</Value> </Tag> </TagSet> </Tagging> |
响应消息头
该请求的响应消息使用公共消息头，具体请参考3.3-表 公共响应消息头。
响应消息元素
在此请求返回的响应消息体中包含的配置元素，具体参见表3 对象的标签配置元素。
错误响应消息
除了公共的错误码外，此接口还会返回一些其他的错误码。下表中列出本接口的一些常见错误，以及可能原因。如下表1 获取对象标签的错误码列表。
请求示例
1 2 3 4 5 6 |
GET /objectname?tagging&versionId=G001018455096CE600005306000000DD HTTP/1.1 User-Agent: curl/7.29.0 Host: bucketname.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: Wed, 27 Jun 2018 13:25:44 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:H1INcyc5i0XlHqYTfuzkPxLZUPM= |
响应示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
HTTP/1.1 200 OK x-obs-request-id: 0002B7532E0000015BEB35330C5884X1 x-obs-id-2: s12w20LYNQqSb7moq4ibgJwmQRSmVQV+rFBqplOGYkXUpXeS/nOmbkyD+E35K79j x-obs-version-id: G001018455096CE600005306000000DD Content-Type: application/xml Date: Wed, 27 Jun 2018 13:25:44 GMT Content-Length: 441 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Tagging xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/"> <TagSet> <Tag> <Key>TagName1</Key> <Value>TageSetVaule1</Value> </Tag> </TagSet> </Tagging> |
