跳到主要内容

参数​

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

  • rules

    array[object]

    要执行的一组或多组匹配条件和动作。

    • match

      array[object]

      用于条件流量拆分的匹配规则。

      • vars

        array[array]

        一个或多个 APISIX 表达式 形式的匹配条件数组，用于按条件执行插件。

    • weighted_upstreams

      array[object]

      上游配置列表。

      • upstream_id

        string or integer

        配置的上游对象的 ID。

      • weight

        integer

        default: 1

        每个上游的权重。

      • upstream

        object

        上游的配置。

        此处不支持 upstream 的某些配置选项。这些字段包括 service_name、discovery_type、checks、retries、retry_timeout、desc 和 labels。作为解决方法，您可以创建一个上游对象并在 upstream_id 中配置它。

        • type

          string

          default: roundrobin

          vaild vaule:

          roundrobin or chash

          流量拆分算法。roundrobin 表示加权轮询，chash 表示一致性哈希。

        • hash_on

          string

          default: vars

          vaild vaule:

          vars, headers, cookie, consumer, or vars_combinations

          当 type 为 chash 时使用。支持对内置变量、请求头、Cookie、消费者或内置变量的组合进行哈希。

        • key

          string

          当 type 为 chash 时使用。当 hash_on 设置为 headers 或 cookie 时，key 是必需的。当 hash_on 设置为 consumer 时，不需要 key，因为消费者名称将自动用作 key。

        • nodes

          object

          上游节点的地址。

        • timeout

          object

          连接、发送和接收消息的超时时间（以秒为单位）。

        • pass_host

          string

          default: pass

          vaild vaule:

          pass, node, or rewrite

          决定如何传递主机名的模式。pass 将客户端的主机名传递给上游。node 传递上游节点中配置的主机。rewrite 传递 upstream_host 中配置的值。

        • upstream_host

          string

          当 pass_host 为 rewrite 时使用。上游的主机名。

        • name

          string

          上游的标识符，用于指定服务名称、使用场景等。