更新时间：2026-04-15 GMT+08:00
获取对象标签-GetObjectTagging
功能介绍
可通过本接口获取对象的标签信息。了解更多对象标签相关信息，请参考对象标签。
授权信息
您必须是对象拥有者或拥有获取对象标签的权限，才能调用本接口，建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。
- 如果使用IAM授权，那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种，并配置相应权限：
- 如果使用角色与策略授权（旧版IAM，即IAM v3接口），需具备obs:object:GetObjectTagging（未开启多版本）、obs:object:GetObjectVersionTagging（开启或暂停多版本）权限，授权操作请参见创建IAM自定义策略。
- 如果使用身份策略授权（新版IAM，即IAM v5接口），如下表所示，需具备obs:object:getObjectTagging（未开启多版本）、obs:object:getObjectVersionTagging（开启或暂停多版本）权限，授权操作请参见创建IAM自定义身份策略。
授权项
Action
访问级别
Access Level
资源类型（*为必须）
Resource Type (*: required)
Condition Key
Alias
依赖的授权项
Dependencies
obs:object:getObjectTagging（未开启多版本）
obs:object:getObjectVersionTagging（开启或暂停多版本）
Read
object *
-
-
- 如果使用桶策略进行授权，需具备obs:object:GetObjectTagging（未开启多版本）、obs:object:GetObjectVersionTagging（开启或暂停多版本）权限，具体操作请参见自定义创建桶策略。
请求消息样式
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 |
URI参数（URI Parameters）
该请求使用的消息参数如下表1 请求消息参数所示。
请求头参数（Request headers）
该请求使用公共请求头，具体参见表3。
请求体参数（Request body）
该请求消息中不带请求体参数。
响应消息样式
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> |
响应头 (Response Headers)
该请求的响应消息使用公共响应头，具体请参考表1。
响应体 (Response Body)
在此请求返回的响应消息体中包含的配置元素，具体参见表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>TagSetValue1</Value> </Tag> </TagSet> </Tagging> |
使用SDK调用接口
建议您使用OBS SDK调用接口。SDK对API进行了封装以简化您的开发工作，直接调用SDK接口函数即可访问OBS，无需手动计算签名。
