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
。
-
具有公共端点
使用以下模式映射规则是 工具 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 和工具 for Devs- 都会受到影响:-
cool API 将具有具有此模式的映射规则:
/echo/ping
-
针对 Devs 的工具 将具有具有此模式的映射规则:
/tellmeback/ping
-
cool API 将具有具有此模式的映射规则: