管理对象标签
TOS 支持为对象设置标签,按照标签对桶中对象进行分类。您可以使用对象标签筛选对象,完成特定对象的生命周期管理和存储桶复制管理。本文介绍对象标签的相关说明及管理对象的操作步骤。
使用限制
对象标签由一组键值对(Key-Value)组成,标签限制如下:
- 例如以下规则指定拥有 data:image 标签的最新版本对象,如果在 120 天内未被修改,将被删除。
- 设置跨区域复制规则或同区域复制规则时,您可以指定对象标签来筛选对象。此时,使用跨区域复制或同区域复制功能同步文件,仅会同步拥有指定标签的对象。具体操作,请参见跨区域复制概述和同区域复制概述。
- 例如以下规则指定将源桶中拥有 data:image 标签的最新版本和历史版本对象复制到 Target Bucket Name 桶中。
"Role": "ServiceRoleforReplicationAccessTOS",
"Bucket": "Target Bucket Name",
"Location": "cn-beijing",
"StorageClass": "STANDARD"
"HistoricalObjectReplication": "Enabled",
"AccessControlTranslation": {
"Owner": "BucketOwnerEntrusted"
设置对象标签前,请确保您已拥有对象标签的相应权限。只有 Bucket 创建者及拥有对象标签读写权限的用户才能读写标签。您可以通过桶策略授予用户对象标签的读写权限,详细信息,请参见桶策略说明。相关动作说明如下: - GetObjectTagging:获取对象标签。
- PutObjectTagging:设置对象标签。
- DeleteObjectTagging:删除对象标签。
您可以在控制台为已上传的对象添加标签,也可以通过 API 或 SDK 在上传对象时为对象添加标签,具体说明如下:
您可以在上传对象时使用 x‑tos‑tagging 请求头指定对象标签,具体支持的 API 如下:
- 在文件列表页面,选择指定文件操作列的 ··· > 编辑标签。
- 在弹出的对话框中,单击添加字段图标,根据需要设置标签键及标签值。
- 在文件列表页面,选择指定文件操作列的 ··· > 编辑标签。
最近更新时间:2026.07.14 18:36:43