跳转至

添加 API

微服务网关支持对网关实例的 API 进行全生命周期管理,包括 API 的添加、更新和删除。本页介绍如何添加 API。

前提条件

  • 有可选的域名,可参考域名管理创建域名。
  • 如果 API 的目标服务为后端服务,则需要确保有可选的后端服务,可参考通过手动自动方式接入服务。

创建 API 的步骤如下:

  1. 点击网关名称进入网关概览页面,然后在左侧导航栏点击 API 管理,在页面右上角点击 添加 API

    进入添加页面

  2. 参考下方说明填写基本配置。

    配置分为基本配置和策略配置两部分。填写基本配置信息时需要注意:

    • API 名称:包含小写字母、数字和以及特殊字符(- .),不能以特殊字符开头和结尾。
    • API 分组:选择 API 所属的分组组名。如果输入不存在的分组名称,则自动创建一个新的分组。
    • 关联域名:填写关联域名后,可以通过域名 + 端口号的方式访问 API。找不到域名时可以添加新域名,可参考添加域名
    • 匹配规则:只允许符合该规则的请求通过。如果设置了多条规则,需要同时满足所有规则才能放行。如果添加了请求头,则需要在访问该 API 时添加相应的请求头。
    • 请求方法:选择 HTTP 协议的请求方式。有关各种请求方式的详细说明,可参考 W3C 的官方文档方式定义
    • 目标服务:选择将请求直接发送到后端服务,或者重定向到其他服务,或者直接返回 HTTP 状态码。
    • 如果选择后端服务,则需要配置权重。权重越大,网关向其分发的流量就越多。

      配置信息

  3. 参考下方说明填写策略配置(选填)。

    支持 11 种 API 策略:负载均衡、路径改写、超时配置、重试机制、请求头重写、响应头重写、Websocket、本地限流、健康检查、cookie 重写、访问黑白名单。有关各项策略的配置说明,可参考API 策略配置

    配置策略

  4. 参考下方说明填写安全配置(选填)。

    • JWT 认证:开启或禁用 JWT 认证
    • 安全认证:开启或禁用安全认证

      配置策略

  5. 在页面右下角点击保存(不上线)。如果点击保存并上线则可以直接上线 API。

    点击确定后,如果所有配置都正常,右上角会弹出创建网关 API 成功的提示信息。可以在 API 管理页面查看新建的 API。

    创建成功

  6. API 上线

    API 创建成功后,默认处于下线状态,此时无法访问。需要将 API 调整为上线,才能正常访问。API 上线有两种方式。

    • 在 API在 API 管理页面找到需要更新的 API,在该 API 的右侧点击 选择API 上线

      API 上线

    • 点击 API 名称进入 API 详情页,在页面右上角点击 并选择API 上线

      API 上线

Info

点击 API 名称进入 API 详情,可查看 API 的详细配置信息,例如上下线状态、域名、匹配规则、目标服务、策略配置等。

API 上线

评论