Language (proto)

This extension has the qualified name envoy.filters.http.language

Note

This extension is only available in contrib images.

Note

This extension is functional but has not had substantial production burn time, use only with this caveat.

This extension is not hardened and should only be used in deployments where both the downstream and upstream are trusted.

Tip

This extension extends and can be used with the following extension category:

Language configuration overview.

extensions.filters.http.language.v3alpha.Language

[extensions.filters.http.language.v3alpha.Language proto]

Language detection filter config.

{
  "default_language": ...,
  "supported_languages": [],
  "clear_route_cache": ...
}
default_language

(string, REQUIRED) The default language to be used as a fallback. The value will be included in the list of the supported languages.

See https://unicode-org.github.io/icu/userguide/locale/

supported_languages

(repeated string, REQUIRED) The set of supported languages. There is no order priority. The order will be determined by the Accept-Language header priority list of the client.

See https://unicode-org.github.io/icu/userguide/locale/

clear_route_cache

(bool) If the x-language header is altered, clear the route cache for the current request. This should be set if the route configuration may depend on the x-language header. Otherwise it should be unset to avoid the performance cost of route recalculation.