1.2. 3scale API Management API の使用状況を把握するために APIcast がマッピングルールをどのように適用するか

API に対するリクエストに基づいて、マッピングルールにより API の使用状況を把握するメトリックまたはメソッドを定義、指定します。マッピングルールの例を以下に示します。

View larger image

このルールは、/ で始まるすべての GET リクエストがメトリック hits のカウントを 1 つ増やす、という意味です。このルールは API に対するすべてのリクエストにマッチします。これは有効なマッピングルールですが、一般的すぎるので、より具体的なルールが追加された時に、2 倍にカウントされることになります。

より具体的なルールの例として、Echo API マッピングルールを以下に示します。

View larger image

マッピングルールは、API プロダクトレベルおよび API バックエンドレベルで機能します。

ここで、同じ Echo API バックエンドを使用する Tools For Devs というプロダクトを追加することを考えてみます。

(get) /path/to/example/search
(get) /path/to/example/{id}

(get) /path/to/example/search
(get) /path/to/example/{id}

ルール /path/to/example/search には Last? とマークできます。次に、(get)/path/to/example/search を呼び出すと、このルールでの照合を行った後、APIcast は処理を停止して、残りのルールでの照合は行われません。また、ルールのメトリクス (get)/path/to/example/{id} はインクリメントされません。