.. _envoy_v3_api_file_envoy/extensions/filters/http/cache/v3alpha/cache.proto: HTTP Cache Filter ================= .. warning:: This API is work-in-progress and is subject to breaking changes. .. _envoy_v3_api_msg_extensions.filters.http.cache.v3alpha.CacheConfig: extensions.filters.http.cache.v3alpha.CacheConfig ------------------------------------------------- `[extensions.filters.http.cache.v3alpha.CacheConfig proto] `_ .. _extension_envoy.filters.http.cache.simple_http_cache: This extension may be referenced by the qualified name *envoy.filters.http.cache.simple_http_cache* .. note:: This extension is work-in-progress. Functionality is incomplete and it is not intended for production use. This extension is intended to be robust against both untrusted downstream and upstream traffic. .. tip:: This extension extends and can be used with the following extension category: - :ref:`envoy.filters.http ` .. code-block:: json { "typed_config": "{...}", "allowed_vary_headers": [] } .. _envoy_v3_api_field_extensions.filters.http.cache.v3alpha.CacheConfig.typed_config: typed_config (`Any `_) Config specific to the cache storage implementation. .. _envoy_v3_api_field_extensions.filters.http.cache.v3alpha.CacheConfig.allowed_vary_headers: allowed_vary_headers (**repeated** :ref:`type.matcher.v3.StringMatcher `) List of matching rules that defines allowed *Vary* headers. The *vary* response header holds a list of header names that affect the contents of a response, as described by https://httpwg.org/specs/rfc7234.html#caching.negotiated.responses. During insertion, *allowed_vary_headers* acts as a allowlist: if a response's *vary* header mentions any header names that aren't matched by any rules in *allowed_vary_headers*, that response will not be cached. During lookup, *allowed_vary_headers* controls what request headers will be sent to the cache storage implementation.