This filter operates on downstream headers to determine the operation name and map variable bindings for an API request. It then updates the shared filter state, reducing redundant work in later filters.
State modifications:
- Modifies shared filter state
In a Google Cloud Endpoints service configuration, each API path is identified by a unique selector. This is documented in the path matcher bootstrap configuration test.
This filter matches the request path to an operation (selector) and stores it in the shared filter state. The results of this match are used the following filters:
This selector is used by these filters (instead of the path) for a variety of operations:
- Selecting a JWT provider for client authentication
- Checking if an API key is required
- Rewriting paths for remote backends
- Attached a JWT for backend authentication
In a Google Cloud Endpoints service configuration, certain variables may need to be extracted from a request path. This is documented in the path matcher bootstrap configuration test.
This filter extracts variable bindings, transforms them into query parameters, and stores them in the shared filter state. The result of the transformation is used by the following filters:
The variable bindings are used for:
- Attaching query parameters to the request
If the original request has a X-HTTP-Method-Override header, this filter will overwrite
the :method header. This will result in all future headers handling the request with
the overridden path.
View the path matcher configuration proto for inline documentation.