.. _envoy_api_file_envoy/type/matcher/string.proto: StringMatcher ============= .. _envoy_api_msg_type.matcher.StringMatcher: type.matcher.StringMatcher -------------------------- `[type.matcher.StringMatcher proto] `_ Specifies the way to match a string. .. code-block:: json { "exact": "...", "prefix": "...", "suffix": "...", "regex": "..." } .. _envoy_api_field_type.matcher.StringMatcher.exact: exact (`string `_) The input string must match exactly the string specified here. Examples: * *abc* only matches the value *abc*. Precisely one of :ref:`exact `, :ref:`prefix `, :ref:`suffix `, :ref:`regex ` must be set. .. _envoy_api_field_type.matcher.StringMatcher.prefix: prefix (`string `_) The input string must have the prefix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * *abc* matches the value *abc.xyz* Precisely one of :ref:`exact `, :ref:`prefix `, :ref:`suffix `, :ref:`regex ` must be set. .. _envoy_api_field_type.matcher.StringMatcher.suffix: suffix (`string `_) The input string must have the suffix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * *abc* matches the value *xyz.abc* Precisely one of :ref:`exact `, :ref:`prefix `, :ref:`suffix `, :ref:`regex ` must be set. .. _envoy_api_field_type.matcher.StringMatcher.regex: regex (`string `_) The input string must match the regular expression specified here. The regex grammar is defined `here `_. Examples: * The regex *\d{3}* matches the value *123* * The regex *\d{3}* does not match the value *1234* * The regex *\d{3}* does not match the value *123.456* Precisely one of :ref:`exact `, :ref:`prefix `, :ref:`suffix `, :ref:`regex ` must be set. .. _envoy_api_msg_type.matcher.ListStringMatcher: type.matcher.ListStringMatcher ------------------------------ `[type.matcher.ListStringMatcher proto] `_ Specifies a list of ways to match a string. .. code-block:: json { "patterns": [] } .. _envoy_api_field_type.matcher.ListStringMatcher.patterns: patterns (:ref:`type.matcher.StringMatcher `, *REQUIRED*)