操作场景
消费者标签用于以 Key-Value 维度治理 API 访问。在“消费者管理 > 消费者标签”页面统一管理消费者可使用的标签值，新增/修改后所有消费者管理、配额、限流、认证授权模块可见。
标签格式为 Key:Value（KV），如“部门:技术部”、“环境:生产”、“等级:VIP”。不同标签 Key 相互独立，一个消费者可绑定多个标签（不同 Key 可共存，同 Key 只保留最新值）。
通过消费者标签，您可以：
让配额、限流、认证授权等策略按标签维度动态匹配，而非逐个消费者配置。
团队人员变动时，新增/移除消费者后自动继承已有标签策略。
查看标签被哪些策略引用，删除前进行依赖关系检查。
前提条件
已创建 AI 网关实例，实例状态为运行中。
如需绑定标签，已创建消费者。
操作步骤
步骤1：新建消费者标签
1. 登录 AI 网关控制台，选择目标网关实例进入详情页。
2. 在左侧导航栏选择消费者管理，进入消费者管理页面。页面提供 4 个页签：消费者组、消费者、消费者标签、消费者密钥。
3. 选择消费者标签页签，单击新建标签。
4. 在“新建消费者标签”弹窗中，配置以下参数：
参数 | 是否必填 | 说明 |
标签 Key | 是 | 输入标签类别，如：部门 / 环境 / 等级。 |
标签 Value | 是 | 输入标签值，如：技术部 / 生产 / VIP。标签为 Key:Value 格式。同 Key 的标签相互覆盖（一个消费者同一 Key 只保留最新 Value）；不同 Key 相互独立（一个消费者可同时绑定 部门:技术部 + 环境:生产）。 |
描述 | 否 | 输入标签描述，最长 200 字符。 |
关联消费者 | 否 | 通过下拉框选择消费者（支持搜索、刷新），可同时选择多个消费者；也可单击新建消费者快速创建。每个标签可以绑定多个消费者，最多 50 个。 |
5. 单击确定，完成创建。
说明：
每个标签最多可以同时绑定 50 个消费者。同 Key 的标签相互覆盖，不同 Key 的标签相互独立；标签创建后可在关联消费者页签中继续管理绑定关系。
标签列表以表格形式展示，每行显示标签名（Key:Value）及关联消费者数，支持按 Key:Value 搜索（搜索框位于列表上方）及刷新。
列表支持分页（默认 20 条/页）。
步骤2：关联消费者
标签创建后，可在标签详情的“关联消费者”页签中继续管理绑定关系。
1. 在消费者标签列表中，单击目标标签（Key:Value），右侧展开标签详情面板。
2. 选择关联消费者页签，页面展示已绑定该标签的消费者列表，包含以下列：ID/名称、所属消费者组、标签状态、描述、操作。支持按消费者 ID、名称搜索。
3. 单击关联消费者按钮，在弹窗中通过穿梭框选择消费者：
左侧：通过消费者下拉框选择（支持按消费者 ID、名称搜索），加入待选列表。
右侧：已选择列表展示已选消费者。
弹窗顶部展示标签值（如 部门:技术部）及已选择消费者数。
4. 单击确定，完成绑定。
步骤3：查看标签详情与引用汇总
单击标签列表中的目标标签，右侧展开详情面板，包含三个页签及编辑、删除操作按钮。
基本信息页签展示：
字段 | 说明 |
标签 Key | 标签类别。 |
标签 Value | 标签值。 |
状态 | 标签状态。 |
关联消费者数 | 当前绑定该标签的消费者数量。 |
创建时间 | 标签创建时间。 |
修改时间 | 最近修改时间。 |
描述 | 标签描述。 |
引用汇总页签展示该标签被策略引用的列表，包含以下列：
列名 | 说明 |
引用类型 | 引用该标签的策略类型。 |
引用内容 | 策略的具体内容。 |
引用资源 ID | 策略对应的资源 ID。 |
步骤4：编辑标签
1. 在标签详情面板，单击编辑。
2. 在“编辑消费者标签”弹窗中，修改标签 Key、标签 Value 或描述（规则同新建）。
3. 单击确定，保存修改。
说明：
编辑弹窗中不含“关联消费者”配置，绑定关系请在关联消费者页签中管理。
步骤5：删除标签
1. 在标签详情面板，单击删除。
2. 在“删除消费者标签”弹窗中，系统自动执行资源删除依赖关系检查，展示检查结果及依赖项统计：
关联消费者：N 个
认证授权 / 限流规则引用：N 个
如依赖关系有变化，可单击重新检查再次校验。
3. 确认检查结果后，单击确定，完成删除。
引用标签
配额管理：新建/编辑配额规则时，配额对象方式可选择按消费者标签，配额将作用于所有匹配该标签的消费者，实现团队维度配额管控。
限流策略：限流条件维度可按消费者标签过滤，支持标签组合，限流策略生效范围自动匹配对应消费者。
认证授权：模型 API 认证授权支持按消费者标签授权，所有匹配标签的消费者自动获得访问权。
参数说明
元素 | 说明 |
标签格式 | Key:Value，如 部门:技术部、环境:生产、等级:VIP。 |
Key 规则 | 不同标签 Key 相互独立。 |
Value 规则 | 同 Key 只保留最新绑定值。 |
绑定关系 | 一个消费者可绑定多个不同 Key 的标签；每个标签最多绑定 50 个消费者。 |
删除影响 | 删除标签不影响现有配额和限流规则，标签自动从所有关联消费者身上解除。 |
