云原生智能网关 消费者标签

一、操作场景

标签格式为 Key:Value（KV），如“部门:技术部”、“环境:生产”、“等级:VIP”。不同标签 Key 相互独立，一个消费者可绑定多个标签（不同 Key 可共存，同 Key 只保留最新值）。

通过消费者标签，你可以：

·让配额、限流、认证授权等策略按标签维度动态匹配，而非逐个消费者配置。

·团队人员变动时，新增/移除消费者后自动继承已有标签策略。

·查看标签被哪些策略引用，删除前进行依赖关系检查。

二、前提条件

·已创建 AI 网关实例，实例状态为运行中。

·如需绑定标签，已创建消费者。

三、步骤1：新建消费者标签

1. 登录 AI 网关控制台，选择目标网关实例进入详情页。

2. 在左侧导航栏选择消费者管理，进入消费者管理页面。页面提供 4 个页签：消费者组、消费者、消费者标签、消费者密钥。

3. 选择消费者标签页签，单击新建标签。

4. 在“新建消费者标签”弹窗中，配置以下参数：

5. 单击确定，完成创建。

注意：说明：

四、步骤2：关联消费者

标签创建后，可在标签详情的“关联消费者”页签中继续管理绑定关系。

1. 在消费者标签列表中，单击目标标签（Key:Value），右侧展开标签详情面板。

2. 选择关联消费者页签，页面展示已绑定该标签的消费者列表，包含以下列：ID/名称、所属消费者组、标签状态、描述、操作。支持按消费者 ID、名称搜索。

3. 单击关联消费者按钮，在弹窗中通过穿梭框选择消费者：

·左侧：通过消费者下拉框选择（支持按消费者 ID、名称搜索），加入待选列表。

·右侧：已选择列表展示已选消费者。

·弹窗顶部展示标签值（如 部门:技术部）及已选择消费者数。

4. 单击确定，完成绑定。

五、步骤3：查看标签详情与引用汇总

单击标签列表中的目标标签，右侧展开详情面板，包含三个页签及编辑、删除操作按钮。

基本信息页签展示：

引用汇总页签展示该标签被策略引用的列表，包含以下列：

六、步骤4：编辑标签

1. 在标签详情面板，单击编辑。

2. 在“编辑消费者标签”弹窗中，修改标签 Key、标签 Value 或描述（规则同新建）。

3. 单击确定，保存修改。

注意：说明：

注意：编辑弹窗中不含“关联消费者”配置，绑定关系请在关联消费者页签中管理。

七、步骤5：删除标签

1. 在标签详情面板，单击删除。

2. 在“删除消费者标签”弹窗中，系统自动执行资源删除依赖关系检查，展示检查结果及依赖项统计：

·关联消费者：N 个

·认证授权 / 限流规则引用：N 个

如依赖关系有变化，可单击重新检查再次校验。

3. 确认检查结果后，单击确定，完成删除。

八、引用标签

·配额管理：新建/编辑配额规则时，配额对象方式可选择按消费者标签，配额将作用于所有匹配该标签的消费者，实现团队维度配额管控。

·限流策略：限流条件维度可按消费者标签过滤，支持标签组合，限流策略生效范围自动匹配对应消费者。

·认证授权：模型 API 认证授权支持按消费者标签授权，所有匹配标签的消费者自动获得访问权。

九、参数说明