文档中心

云数据库 TiDB 版

标签管理

绑定或添加标签

云数据库 TiDB 版支持标签管理功能，标签可用于标识资源，帮助您从不同维度（如用途、类型、所有者、环境等）对具有相同特征的集群进行标记和分类，便于筛选和管理。本文介绍如何为集群绑定标签。

前提条件

已创建集群，且集群状态为 Active。关于集群状态的更多详情，请参见查看集群概览。

标签设置规则

云数据库 TiDB 版标签设置规则如下表所示。

限制项	说明
标签键	支持任何语言字母（如英文字母）或文字（如中文）、数字、空格，以及如下特殊字符：_.:/=+-@。标签键的长度需为 1~128 个字符。标签键区分大小写，如 Type 和 type 是两个不同的标签键。 volc:、sys: 为系统预留的标签键，添加标签时，不能设置以任何大小写形式的 volc:、sys: 作为标签键的开头。
标签值	支持任何语言字母（如英文字母）或文字（如中文）、数字、空格，以及如下特殊字符：_.:/=+-@。标签值区分大小写，如 Shard 和 shard 是两个不同的标签值。标签值的长度需为 0~256 个字符，即标签值可以为空。
数量	标签总数量无限制，但每个 TiDB 集群最多可绑定 50 个标签。每次设置最多可添加 20 个标签。

注意事项

若通过子用户（即 IAM 用户）在云数据库 TiDB 版中使用资源标签，需确保已为 IAM 用户授予对应的权限策略。更多详情，请参见 IAM 用户使用资源标签。

操作步骤

说明

绑定标签对集群运行无影响。

说明

若通过子用户在 TiDB 集群中使用资源标签，需要主账号先为子用户在全局范围内添加 TagFullAccess 权限策略，才能在下拉列表中看到主账号下的已有标签，否则下拉列表为空；但子用户即使没有 TagFullAccess 权限，也可以为集群添加新标签。更多详情，请参见通过子用户使用 TiDB 服务。

最近更新时间：2026.09.24 11:41:02

这个页面对您有帮助吗？

有用

无用