标签
API7 企业版中的标签是附加到各种实体的键值元数据,以简化组织、过滤和管理。随着基础设施的发展,标签对于按团队、环 境或应用程序识别和分类资源变得至关重要。
应用实体
你可以将标签应用于以下实体:
- 服务:按业务单位(例如,
department: sales)或应用程序类型(例如,app_type: internal)分组。 - 路由:通过API版本(例如,
version: v1)或稳定性(例如,status: stable)。 - 消费者:按客户端类型(例如,
client: mobile-app)或订阅层(e.g.)对API消费者进行分类tier: gold)。 - 网关组:按区域(例如,
region: us-east)或提供商(例如,cloud: aws)识别组。 - SSL 证书:按颁发者(例如,
issuer: letsencrypt)或到期年份跟踪证书。
模式结构
标签遵循简单的 key: value 模式。在控制面API 中,标签通常作为 AllLabels 对象返回 — 一个映射,其中每个键都包含整个系统中为其分配的值的数组。
- 标签键:必须是唯一且具有描述性的(例如,
env、project)。 - 标签值:该密钥的具体值(例如,
prod、auth-service)。
用例
控制台过滤
API7 网关控制台使用标签来过滤和搜索资源。你无需滚动浏览数百个服务,而是可以按特定标签进行筛选以仅查看相关项目。
资源组织
将资源分组到逻辑命名空间中以管理权限和可见性。例如,你可以使用 team: payment 标记属于“付款”团队的所有资源,以便管理员轻松审核其配置。
基于策略的路由
在高级配置中,你可以使用消费者标签来应用条件策略。例如,插件可以检查消费者是否具有标签 tier: gold,并授予它们比 tier: silver消费者更高的限流。