跳到主要内容
版本:3.10.x

标签

API7 企业版(API7 网关)中的标签是附加到各类实体的键值元数据,用于简化资源的组织、筛选和管理。随着基础设施规模扩大,你可以使用标签按团队、环境或应用识别和分类资源。

应用实体

你可以将标签应用于以下实体:

  • 服务:按业务单位(例如,department: sales)或应用程序类型(例如,app_type: internal)分组。
  • 路由:按 API 版本(例如 version: v1)或稳定性(例如 status: stable)进行分类。
  • 消费者:按客户端类型(例如 client: mobile-app)或订阅级别(例如 tier: gold)对 API 消费者进行分类。
  • 网关组:按区域(例如,region: us-east)或提供商(例如,cloud: aws)识别组。
  • SSL 证书:按颁发者(例如,issuer: letsencrypt)或到期年份跟踪证书。

模式结构

标签采用简单的 key: value 格式。在控制面 API 中,标签通常以 AllLabels 对象返回。该对象是一个映射,其中每个键对应系统中为该键设置过的所有值。

  • 标签键:必须是唯一且具有描述性的(例如,envproject)。
  • 标签值:标签键对应的具体值(例如 prodauth-service)。

用例

控制台过滤

API7 网关控制台使用标签来过滤和搜索资源。你无需滚动浏览数百个服务,而是可以按特定标签进行筛选以仅查看相关项目。

资源组织

将资源分组到逻辑命名空间中以管理权限和可见性。例如,你可以使用 team: payment 标记属于“付款”团队的所有资源,以便管理员轻松审核其配置。

基于策略的路由

在高级配置中,可以根据消费者标签应用条件策略。例如,插件可以检查消费者是否带有 tier: gold 标签,并为其设置比 tier: silver 消费者更高的限流配额。

后续步骤