The Filter Resource (v1alpha1)

The Filter custom resource works in conjunction with the FilterPolicy custom resource to define how and when Ambassador Edge Stack will modify or intercept incoming requests before sending them to your upstream Service. Filters define what actions to take on a request, while FilterPolicies define the matching criteria for requests, such as the headers, hostname, and path, and supply references to one or more Filters to execute against those requests. Filters are largely used to add built-in authentication and security, but Ambassador Edge Stack also supports developing custom filters to add your own processing and logic.

This doc is an overview of all the fields on the Filter Custom Resource with descriptions of the purpose, type, and default values of those fields. This page is specific to the gateway.getambassador.io/v1alpha1 version of the Filter resource. For the older getambassador.io/v3alpha1 resource, please see the v3alpha1 Filter api reference.

Filter API Reference

Filtering is configured using Filter custom resources. The body of the resource spec depends on the filter type:

FilterSpec

FilterStatus

This field is set automatically by Ambassador Edge Stack to provide info about the status of the Filter.