You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

复制全文
下载 pdf
文件管理
管理对象标签
复制全文
下载 pdf
管理对象标签
TOS 支持为对象设置标签,按照标签对桶中对象进行分类。您可以使用对象标签筛选对象,完成特定对象的生命周期管理和存储桶复制管理。本文介绍对象标签的相关说明及管理对象的操作步骤。​
使用限制​
对象标签由一组键值对(Key-Value)组成,标签限制如下:​
​
限制项​
说明​
计费​
目前对象标签功能处于免费阶段,收费时间及收费标准会提前另行通知,请您及时关注相应通知。​
标签数量​
每个对象最多可添加 10 个标签,且同一对象的 Key 不能重复。​
标签键值对(Key-Value)​
  • Key 的长度不超过 128 个字符。​
  • Value 的长度不超过 256 个字符。​
  • Key 和 Value 均区分大小写,合法字符集包括大小写字母、数字、空格和特殊符号 _ . : / = + -。​
其他​
  • 如果您需要使用 HTTP Header 的方式设置对象标签且标签中包含任意字符时,标签的 Key 和 Value 需要进行 URL 编码。​
  • 更改对象的标签信息,对象的 Last-Modified 时间不会更新。​
  • 跨区域复制或同区域复制时,不会复制对象的标签信息。​
​
使用场景​
  • 对象标签结合生命周期​
  • 例如以下规则指定拥有 data:image 标签的最新版本对象,如果在 120 天内未被修改,将被删除。​
  • ​
    {​
    "Rules": [{​
    "ID": "id",​
    "Tags": {​
    "Key": "data",​
    "Value": "image"​
    },​
    "Status": "Enabled",​
    "Expiration": {​
    "Days": "120"​
    }​
    }]​
    }​
    ​
  • 对象标签结合存储桶复制​
  • 设置跨区域复制规则或同区域复制规则时,您可以指定对象标签来筛选对象。此时,使用跨区域复制或同区域复制功能同步文件,仅会同步拥有指定标签的对象。具体操作,请参见跨区域复制概述和同区域复制概述。​
  • 例如以下规则指定将源桶中拥有 data:image 标签的最新版本和历史版本对象复制到 Target Bucket Name 桶中。​
  • ​
    {​
    "Role": "ServiceRoleforReplicationAccessTOS",​
    "Rules": [{​
    "ID": "1",​
    "Status": "Enabled",​
    "Tags": {​
    "Key": "data",​
    "Value": "image"​
    },​
    "Destination": {​
    "Bucket": "Target Bucket Name",​
    "Location": "cn-beijing",​
    "StorageClass": "STANDARD"​
    },​
    "HistoricalObjectReplication": "Enabled",​
    "AccessControlTranslation": {​
    "Owner": "BucketOwnerEntrusted"​
    }​
    }]​
    }​
    ​
权限说明​
设置对象标签前,请确保您已拥有对象标签的相应权限。只有 Bucket 创建者及拥有对象标签读写权限的用户才能读写标签。您可以通过桶策略授予用户对象标签的读写权限,详细信息,请参见桶策略说明。相关动作说明如下:​
  • GetObjectTagging:获取对象标签。​
  • PutObjectTagging:设置对象标签。​
  • DeleteObjectTagging:删除对象标签。​
添加对象标签​
您可以在控制台为已上传的对象添加标签,也可以通过 API 或 SDK 在上传对象时为对象添加标签,具体说明如下:​
​
上传对象时添加标签
上传对象后添加标签
​
您可以在上传对象时使用 x‑tos‑tagging 请求头指定对象标签,具体支持的 API 如下:​
​
编辑/删除对象标签​
  1. 在左侧导航栏,单击桶列表。​
  1. 在顶部导航栏,选择存储桶所属项目。​
  1. 在桶列表页面,单击目标桶名称。​
  1. 在文件列表页面,选择指定文件操作列的 ··· > 编辑标签。​
  1. 在弹出的对话框中:​
  • 编辑标签:根据需要修改标签信息。​
  • 删除标签:单击删除。​
  1. 设置完成后,单击保存。​
​
​
最近更新时间:2026.07.14 18:36:43
这个页面对您有帮助吗?
有用
有用
无用
无用