管理网关组

网关组可以将数据面实例组织成逻辑组，实现环境隔离（开发/预发布/生产）、团队隔离或按地理位置分组。每个网关组都有独立的配置作用域，并且可以运行不同版本的数据面。

本指南介绍如何使用企业 API 创建、查看和更新网关组。

前置条件

• API7 企业版实例正在运行。
• 一个 Dashboard Token。

创建网关组

可以创建新网关组，在逻辑上归组网关实例。

curl -k "https://localhost:7443/api/gateway_groups" -X POST \
  -H "X-API-KEY: ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "docs-temp-group",
    "description": "Docs validation gateway group",
    "type": "api7_gateway",
    "labels": {
      "env": "docs-test"
    }
  }'

列出网关组

列出网关组可以查看所有现有逻辑组及其配置。

curl -k "https://localhost:7443/api/gateway_groups" \
  -H "X-API-KEY: ${API_KEY}"

生成实例 Token

数据面实例需要 Token 才能注册到网关组。每个网关组都可以生成自己的唯一 Token。

curl -k "https://localhost:7443/api/gateway_groups/{gateway_group_id}/instance_token" -X POST \
  -H "X-API-KEY: ${API_KEY}"

更新网关组

可以更新现有网关组的名称、说明和标签。

curl -k "https://localhost:7443/api/gateway_groups/{gateway_group_id}" -X PUT \
  -H "X-API-KEY: ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "docs-temp-group-updated",
    "description": "Updated docs validation group",
    "labels": {
      "env": "docs-test",
      "team": "docs"
    }
  }'

验证配置

获取特定网关组的详细信息以验证配置。

curl -k "https://localhost:7443/api/gateway_groups/{gateway_group_id}" \
  -H "X-API-KEY: ${API_KEY}"

后续步骤

• 了解网关组——学习相关架构概念。
• 配置密钥管理——管理网关组中的密钥。