跳到主要内容

静态配置​

SOAP Proxy 端点和超时属于网关级设置。请配置每个网关实例都可访问的端点，然后重新加载或滚动更新网关，使静态配置生效。

将 SOAP Proxy 地址添加到网关部署使用的持久化 config.yaml。以下端点与示例中的 Docker 配置一致：

config.yaml
plugin_attr:
  soap:
    endpoint: http://soap-proxy:5000
    timeout: 3000

更新配置源后重新加载网关。宿主机安装可直接运行以下命令；Docker 部署请在网关容器中运行该命令：

apisix reload

参数​

请参阅通用配置了解所有插件可用的配置选项。

  • wsdl_url

    string

    必填

    定义 SOAP 操作和上游服务端点的 WSDL 文档 URL。

  • max_req_body_size

    integer

    默认值：67108864

    有效值：

    大于或等于 1

    插件缓冲到内存中的最大请求体大小（以字节为单位）。更大的请求体会在 SOAP 转换前以 HTTP 400 被拒绝。自 API7 企业版 3.9.17 和 3.10.4 起引入。

  • keepalive

    object

    从网关到 SOAP Proxy 的请求连接复用设置。省略时，插件启用 keepalive，空闲超时为 50 秒，连接池大小为 10。

    • enable

      boolean

      默认值：true

      是否复用到 SOAP Proxy 的连接。当前已发布的运行时始终启用连接复用，因此将此字段设置为 false 不会生效。

    • timeout

      integer

      默认值：30

      有效值：

      大于或等于 10

      配置 keepalive 时，可复用连接的最大空闲时间（秒）。

    • pool

      integer

      默认值：30

      有效值：

      大于或等于 5

      配置 keepalive 时，每个 Worker 保留的可复用 SOAP Proxy 连接数上限。