🤔 Introducing APISIX AI Gateway – Built for LLMs and AI workloads. Learn More

Global rules

描述

Plugin 配置可直接绑定在 Route 上,也可以被绑定在 ServiceConsumer 上。

如果你需要一个能作用于所有请求的 Plugin,可以通过 Global Rules 启用一个全局的插件配置。

全局规则相对于 Route、Service、Plugin Config、Consumer 中的插件配置,Global Rules 中的插件总是优先执行。

使用示例

以下示例展示了如何为所有请求启用 limit-count 插件:

NOTE

您可以这样从 config.yaml 中获取 admin_key 并存入环境变量:

admin_key=$(yq '.deployment.admin.admin_key[0].key' conf/config.yaml | sed 's/"//g')
curl http://127.0.0.1:9180/apisix/admin/global_rules/1 -X PUT \
  -H 'Content-Type: application/json' \
  -H "X-API-KEY: $admin_key" \
  -d '{
        "plugins": {
            "limit-count": {
                "time_window": 60,
                "policy": "local",
                "count": 2,
                "key": "remote_addr",
                "rejected_code": 503
            }
        }
    }'

你也可以通过以下命令查看所有的全局规则:

curl http://127.0.0.1:9180/apisix/admin/global_rules -H "X-API-KEY: $admin_key"