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

文档中心

立即注册

导航

对象存储

PutObjectTagging

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

功能描述

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

版本控制

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

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

注意事项

类别	注意事项
接口	使用 PutObjectTagging 接口设置标签时，存在以下两种情况：如果对象没有标签，PutObjectTagging 接口会为对象添加一组键值对标签。如果对象已有标签，PutObjectTagging 接口会覆盖对象的已有标签。
标签	单个对象最多只能设置 10 个标签。同时设置多个标签时，标签的 Key 不能重复。更改标签信息不会更改对象的 Last‑Modified 时间。
标签的键值对	Key 和 Value 区分大小写。标签的 Key 和 Value 只能由大小写字母、数字、空格，以及英文冒号（：）、加号（+）、短划线（‑）、等于号（=）、英文句号（.）、下划线（_）、正斜线（/）组成。每个 Key 长度不能超过 128 个字符，每个 Value 长度不能超过 256 个字符。通过 HTTP Header 的方式设置标签且标签中包含任意字符时，您需要对标签的 Key 和 Value 进行 URL 编码。

类别

注意事项

接口

使用 PutObjectTagging 接口设置标签时，存在以下两种情况：

如果对象没有标签，PutObjectTagging 接口会为对象添加一组键值对标签。
如果对象已有标签，PutObjectTagging 接口会覆盖对象的已有标签。

标签

单个对象最多只能设置 10 个标签。同时设置多个标签时，标签的 Key 不能重复。
更改标签信息不会更改对象的 Last‑Modified 时间。

标签的键值对

Key 和 Value 区分大小写。
标签的 Key 和 Value 只能由大小写字母、数字、空格，以及英文冒号（：）、加号（+）、短划线（‑）、等于号（=）、英文句号（.）、下划线（_）、正斜线（/）组成。
每个 Key 长度不能超过 128 个字符，每个 Value 长度不能超过 256 个字符。
通过 HTTP Header 的方式设置标签且标签中包含任意字符时，您需要对标签的 Key 和 Value 进行 URL 编码。

请求消息样式

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"
            }
        ]
    }
}

请求参数和消息头

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

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

请求元素

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

响应消息头

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

响应元素

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

请求示例

设置对象标签

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