1.2. 映射规则
根据对 API 的请求,映射规则定义您要报告的指标或方法。以下是映射规则示例:
这个规则表示,任何以 /
开头的 GET
请求都将按 1 增加指标 命中
。此规则将与您的 API 的任何请求匹配。但最有可能会修改这个规则,因为它比较通用,而且在添加更多规则时通常会加倍计数。
Echo API 的以下规则显示更具体的示例:
1.2.1. 在产品和后端映射规则
映射规则在 API 产品和 API 后端级别上工作。在本节中,您将了解每个级别的映射规则的行为,并查看一个示例来描述映射规则如何运作。
在产品级别映射规则
- 映射规则具有优先权。这意味着产品映射规则是第一个要评估的规则。
- 映射规则始终被评估,并且独立于这些后端接收重定向的流量。
在后端级别上映射规则
- 当您向后端添加映射规则时,这些规则将添加到所有产品中,并绑定所述后端。
- 映射规则在产品级别上定义的映射规则后评估。
- 只有在流量重定向到映射规则所属的同一后端时才评估映射规则。
- 产品后端的路径会自动放在捆绑到上述产品的后端的每个映射规则的前面。
使用产品和后端映射规则示例
在本例中,我们从后端和产品开始。
Echo API 后端:
-
具有专用端点:
https://echo-api.3scale.net
- 包含使用以下模式的 2 个映射规则:
-
具有专用端点:
/hello /bye
Cool API 产品:
-
具有这个公共端点:
https://cool.api
-
通过以下路由路径使用 Echo API 后端:
/echo
。
-
具有这个公共端点:
- 使用以下模式映射规则会自动成为 Cool API 产品的一部分:
/echo/hello /echo/bye
-
这意味着,发送到公共 URL
https://cool.api/echo/hello
的请求被重新定向到https://echo-api.3scale.net/hello
-
同样,发送到
https://cool.api/echo/bye
的请求重定向到https://echo-api.3scale.net/bye
现在,请考虑使用同一 Echo API 后端的名为 Tools for Devs 的额外产品。
Tools for Devs 产品:
-
具有公共端点
:https://dev-tools.api
-
通过以下路由路径使用 Echo API 后端:
/tellmeback
。
-
具有公共端点
使用以下模式映射规则是 Tools For Devs 产品的一部分:
/tellmeback/hello /tellmeback/bye
-
因此,发送到公共 URL
https://dev-tools.api/tellmeback/hello
的请求被重新定向到https://echo-api.3scale.net/hello
-
同样,发送到
https://dev-tools.api/tellmeback/bye
的请求重定向到https://echo-api.3scale.net/bye
-
因此,发送到公共 URL
如果您使用
/ping
模式的映射规则添加到 Echo API 后端,则产品 - Cool API 和 Tools For Devs 都会受到影响:-
cool API 将具有带有此模式的映射规则:
/echo/ping
-
Devs 的工具 会有一个带有这个模式的映射规则:
/tellmeback/ping
-
cool API 将具有带有此模式的映射规则: