GetObjectTagging--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

GetObjectTagging

最近更新时间：2024.08.01 20:30:30首次发布时间：2023.04.13 14:38:36

功能描述

调用 GetObjectTagging 接口获取对象（Object）的标签（Tag）信息。

版本控制

如果您的存储桶开启了版本控制功能，调用 GetObjectTagging 接口时，存在以下限制：

默认情况下，该接口将直接获取对象当前版本的标签信息。您可以通过 versionId 参数，获取指定对象版本的标签信息。
如果对象的版本具有删除标记（Delete Marker），您将无法获取对象当前版本的标签信息，TOS 将返回 404 Not Found。

请求消息样式

GET /objectname?tagging
Host: Host: examplebucket.tos.cn-beijing.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue

请求参数和消息头

使用公共请求消息头。更多信息，请参见公共参数。

参数名称	位置	参数类型	是否必选	示例值	说明
tagging	Query	String	是	-	只需设置参数名称，无需设置参数值，代表 GetObjectTagging 请求的特殊标识。
versionId	Query	String	否	57894830D7822B2ACB78	对象的版本号，用于标识获取指定版本的对象标签。

请求元素

该请求无请求消息元素。

响应消息头

返回公共响应消息头。更多信息，请参见公共参数。

响应元素

参数名称	参数类型	示例值	说明
TagSet	Container	-	标签信息集合。
Tags	Container	-	标签信息。
Key	String	aa	标签的键。
Value	String	bb	标签的值。

请求示例

获取对象标签示例

GET /objectname?tagging
Host: bucketname.tos.cn-beijing.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue

获取指定版本对象标签

GET /objectname?tagging&versionId=57894830D7822B2ACB78
Host: bucketname.tos.cn-beijing.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue

响应示例

获取对象标签返回示例

HTTP/1.1 200 OK
date: Wed, 24 Jun 2020 08:57:15 GMT
content-length: 142
server: TosServer
x-tos-id-2: 4fac130bedb6002c-a444ed0
x-tos-request-id: 4fac130bee03002e-a444ed0
{
    "TagSet": {
        "Tags": [
            {
                "Key": "dd", 
                "Value": "ee"
            },
         {
                "Key": "bb", 
                "Value": "cc"
            }
        ]
    }
}

获取指定版本对象标签返回示例

HTTP/1.1 200 OK
date: Wed, 24 Jun 2020 08:58:15 GMT
content-length: 142
server: TosServer
x-tos-id-2: ea2ceb08a4e30021-a444ed0
x-tos-request-id: 5726ce090a2d002d-a444ed0
x-tos-version-id: 57894830D7822B2ACB78
{
    "TagSet": {
        "Tags": [
            {
                "Key": "aa", 
                "Value": "bb"
            },
         {
                "Key": "bb", 
                "Value": "cc"
            }
        ]
    }
}