Omit host metadata retry predicate

This documentation is for the Envoy v3 API.

As of Envoy v1.18 the v2 API has been removed and is no longer supported.

If you are upgrading from v2 API config you may wish to view the v2 API documentation:

config/retry/omit_host_metadata/v2/omit_host_metadata_config.proto

extensions.retry.host.omit_host_metadata.v3.OmitHostMetadataConfig

[extensions.retry.host.omit_host_metadata.v3.OmitHostMetadataConfig proto]

A retry host predicate that can be used to reject a host based on predefined metadata match criteria.

This extension may be referenced by the qualified name envoy.retry_host_predicates.omit_host_metadata

Note

This extension is intended to be robust against untrusted downstream traffic. It assumes that the upstream is trusted.

Tip

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

  1. {
  2. "metadata_match": "{...}"
  3. }

metadata_match

(config.core.v3.Metadata) Retry host predicate metadata match criteria. The hosts in the upstream cluster with matching metadata will be omitted while attempting a retry of a failed request. The metadata should be specified under the envoy.lb key.