1.8. 定义映射规则
映射规则将调用与端点相关联,与指定的方法和指标相关联,用于跟踪和限制对您的 API 的访问。您可以在后端和产品级别上定义映射规则。在后端级别上定义映射规则的优点是您可以向多个产品添加后端。要了解更多有关根据对 API 的请求(在产品和后端级别)收集使用信息的指标或方法,请参阅 APIcast 应用用于捕获 3scale API 管理 API 的映射规则。
先决条件
- 一个后端。要创建它,请参阅为您的产品创建后端。
流程
- 在 Dashboard 中,点您要为其定义映射规则的后端。
- 在导航面板中,单映射规则。
- 点 Create Mapping Rule。
指定以下设置:
Verb
HTTP 请求动词(
GET
、POST
、DELETE
或PUT
)。pattern
要匹配的模式。例如,
/hello
。指标或增量方法
指标或方法名称。
递增
指标递增数。例如,
1
.Last?
如果请求与标记为 Last? 的规则匹配,APIcast 会停止处理,且不会在剩余的映射规则中搜索匹配项,然后也会停止递增其指标。
position
表示执行映射规则的位置的数字,以对映射规则进行排序。
- 点 Create Mapping Rule。
后续步骤
这些步骤后,映射规则会添加到 Backends under [Your_API_backend] > Mapping Rules。该映射规则还可用于目前使用后端的每个产品。要在产品级别上激活映射规则,请在 [Your_product_name] > Integration > Configuration 的 Products 选项卡下提升最新的配置。
示例
提升配置后,3scale 会在产品级别激活后端映射规则。映射规则遵循产品中指定的后端路径。例如,假设您有此配置:
-
后端映射规则的模式:
/thousands
-
使用路径为
/unitprice
的产品中添加后端
产品级别的映射规则为: /unitprice/thousands