功能描述 #

调用 PutObjectTagging 接口为对象（Object）设置和更新标签（Tag）信息。

版本控制 #

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

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

注意事项 #

请求消息样式 #

PUT /objectname?tagging
Content‐Length: 114
Host: Host: examplebucket.tos.cn-beijing.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue
{
    "TagSet": {
        "Tags": [
            {
                "Key": "aa", 
                "Value": "bb"
            },
         {
                "Key": "bb", 
                "Value": "cc"
            }
        ]
    }
}

请求参数和消息头 #

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

请求元素 #

响应消息头 #

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

响应元素 #

该请求响应中无消息元素。

请求示例 #

• 设置对象标签

PUT /objectname?tagging
Content‐Length: 114
Host: bucketname.tos.cn-beijing.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue
{
    "TagSet": {
        "Tags": [
            {
                "Key": "aa", 
                "Value": "bb"
            },
         {
                "Key": "bb", 
                "Value": "cc"
            }
        ]
    }
}

• 设置指定对象版本标签

PUT /objectname?tagging&versionId=57894830D7822B2ACB78
Content‐Length: 114
Host: bucketname.tos.cn-beijing.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue
{
    "TagSet": {
        "Tags": [
            {
                "Key": "aa", 
                "Value": "bb"
            },
         {
                "Key": "bb", 
                "Value": "cc"
            }
        ]
    }
}

响应示例 #

• 设置对象标签后返回示例

HTTP/1.1 200 OK
content-length: 0
server: TosServer
date: Wed, 24 Jun 2020 08:57:15 GMT
x-tos-id-2: 4fac130bedb6002c-a444ed0
x-tos-request-id: 4fac130bee03002e-a444ed0

• 设置指定对象版本标签后返回示例

HTTP/1.1 200 OK
content-length: 0
server: TosServer
date: Wed, 24 Jun 2020 08:58:15 GMT
x-tos-id-2: ea2ceb08a4e30021-a444ed0
x-tos-request-id: 5726ce090a2d002d-a444ed0
x-tos-version-id: 57894830D7822B2ACB78