# Workflow 配置选项

workflow 插件根据特定规则，对客户端流量有条件地执行用户定义的动作，从而支持细粒度的 API 流量管理。<!-- --> <!-- -->配置涵盖插件参数。

## 参数[​](#参数 "参数的直接链接")

有关所有插件均可使用的配置项，请参阅[插件通用配置](https://docs.apiseven.com/apisix/reference/plugin-common-configurations.md)。

* rules

  array\[object]

  必填

  ***

  按顺序评估的规则。只有第一条匹配规则会执行其动作。

  * case

    array\[array]

    ***

    以 [APISIX 表达式](https://docs.apiseven.com/apisix/reference/apisix-expressions.md)表示的匹配条件。省略时，规则始终匹配。请把无条件回退规则放在最后。在 APISIX 3.19.0 中，无效表达式会在配置校验期间被拒绝。

  * actions

    array\[array]

    必填

    ***

    条件匹配成功时要执行的动作数组。目前，该数组仅支持一个动作，且应为 `return`、`limit-count` 或 `limit-conn`。如果你使用的是 API7 企业版，还可以使用 `limit-count-advanced` 作为动作。

    每个动作是一个包含两个元素的数组 `[name, conf]`，其中 `name` 为动作名称，`conf` 为其配置对象。每条规则必须恰好包含一个动作。APISIX 3.19.0 会在配置校验期间强制执行该结构，API7 企业版 3.9.21 和 3.10.8 则由控制面执行。没有配置对象的动作、包含多余元素的动作，以及包含多个动作的规则都会被拒绝。

    当动作设置为 `return` 时，你可以配置在匹配条件时返回给客户端的 HTTP 状态码。

    当动作设置为 `limit-count` 时，你可以配置 [`limit-count`](https://docs.apiseven.com/hub/limit-count/configuration.md) 插件的所有选项，但 `group` 除外。

    当动作设置为 `limit-count-advanced` 时，你可以配置 [`limit-count-advanced`](https://docs.apiseven.com/hub/limit-count-advanced/configuration.md) 插件的所有选项，但 `group` 除外。

    当动作设置为 `limit-conn` 时，你可以配置 [`limit-conn`](https://docs.apiseven.com/hub/limit-conn/configuration.md) 插件的所有选项。
