标签
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 对象返回。该对象是一个映射,其中每个键对应系统中为该键设置过的所有值。
- 标签键:必须是唯一且具有描述性的(例如,
env、project)。 - 标签值:标签键对应的具体值(例如
prod、auth-service)。
用例
控制台过滤
API7 网关控制台使用标签来过滤和搜索资源。你无需滚动浏览数百个服务,而是可以按特定标签进行筛选以仅查看相关项目。
资源组织
将资源分组到逻辑命名空间中以管理权限和可见性。例如,你可以使用 team: payment 标记属于“付款”团队的所有资源,以便管理员轻松审核其配置。
基于策略的路由
在高级配置中,可以根据消费者标签应用条件策略。例如,插件可以检查消费者是否带有 tier: gold 标签,并为其设置比 tier: silver 消费者更高的限流配额。