文档中心

缓存数据库 Redis 版

标签管理

绑定或添加标签

绑定或添加标签

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

前提条件

实例状态需为运行中。关于实例状态的更多详情，请参见实例状态。

标签设置规则

缓存数据库 Redis 版标签设置规则如下表所示。

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

注意事项

同一实例下多个标签的标签键不可重复，且每个标签键只能有一个标签值。

若新绑定的标签键与实例已绑定的标签键重合，则新标签值将覆盖原标签值，请谨慎操作。

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

操作步骤

说明

绑定标签对实例运行无影响。

为单个实例绑定或添加标签

方法一

在创建实例时直接绑定标签。具体操作步骤，请参见创建实例。

方法二

登录 Redis 控制台。

在顶部菜单栏的左上角，选择实例所属的项目和地域。

在实例列表页找到目标实例，单击标签列的图标。

您可以单击目标实例进入实例信息页，在基本信息区域，单击标签列的图标。

在弹出的对话框中，确认实例信息，并根据业务需要从下拉列表中选择已有的标签键和标签值，或者输入新的标签键和标签值。

说明

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

标签键值需满足一定的设置规则，具体规则详情，请参见标签设置规则。

单击确定。

为多个实例批量绑定或添加标签

登录 Redis 控制台。

在顶部菜单栏的左上角，选择实例所属的项目和地域。

在实例列表页，勾选需要绑定标签的目标实例，在实例列表左下角选择 ... > 绑定标签。

在弹出的对话框中，确认实例信息，并根据业务需要从下拉列表中选择已有的标签键和标签值，或者输入新的标签键和标签值。

说明

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

标签键值需满足一定的设置规则，具体规则详情，请参见标签设置规则。

单击确定。

相关 API

API	描述
AddTagsToResource	调用 AddTagsToResource 接口为目标 Redis 实例绑定标签。

最近更新时间：2026.01.14 14:08:12

这个页面对您有帮助吗？

有用

有用

无用

无用