You need to enable JavaScript to run this app.
导航
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 编码。

请求消息样式

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