对象标签概述

最近更新时间:2025-08-08 17:42:01

我的收藏

功能概述

对象标签功能的实现是通过为对象添加一个键值对形式的标识,协助用户分组管理存储桶中的对象。对象标签由标签的键(tagKey)和标签的值(tagValue)与=相连组成,例如group = IT。用户可以对指定的对象进行标签的设定、查询、删除操作。
注意:
对象标签功能为计费项,详细的定价请参见 产品定价 文档。

规格与限制

标签键限制

支持中文, a-z, A-Z, 0-9, +, -, _, =, /, ., :, @等字符,区分英文大小写。
标签键长度范围为1-127个字符(采用 UTF-8 格式)。
标签键区分英文大小写。

标签值限制

支持中文, a-z, A-Z, 0-9, +, -, _, =, /, ., :, @等字符,区分英文大小写。
标签值长度范围为1-255个字符 (采用 UTF-8 格式)。
标签值区分英文大小写。

标签数量限制

对象维度:一个对象最多10个不同的对象标签。
标签维度:无限制。

使用方法

使用对象存储控制台

上传对象时添加标签

1. 上传对象 时添加对象标签。如下图所示:

2. 上传成功后,对象标签即可添加完成。您可以进入存储桶的文件列表页面,找到已添加标签的对象,单击更多 > 添加标签,查看、编辑或删除已添加的标签。




为已上传的对象添加标签

若您在上传对象时未添加标签,您可以按照下述步骤为对象添加标签。
1. 参见 查看对象信息 进入文件列表页面。
2. 在文件列表页面,找到待操作的对象,单击更多 > 添加标签
3. 在弹出的窗口中,单击添加标签,输入标签的键和值,保存即可。



如果您需要修改或删除标签,在此窗口中,单击编辑删除即可。

使用 REST API

您可以通过以下 API 管理对象标签:

常见问题

如何使用对象标签?

当设置了对象标签后,您可以快速对具有相同对象标签的对象设置生命周期规则,详情请参见 设置生命周期