Struct matcher¶

type.matcher.v3.StructMatcher¶

StructMatcher provides a general interface to check if a given value is matched in google.protobuf.Struct. It uses path to retrieve the value from the struct and then check if it’s matched to the specified value.

For example, for the following Struct:

fields:
  a:
    struct_value:
      fields:
        b:
          struct_value:
            fields:
              c:
                string_value: pro
        t:
          list_value:
            values:
              - string_value: m
              - string_value: n

The following MetadataMatcher is matched as the path [a, b, c] will retrieve a string value “pro” from the Metadata which is matched to the specified prefix match.

path:
- key: a
- key: b
- key: c
value:
  string_match:
    prefix: pr

The following StructMatcher is matched as the code will match one of the string values in the list at the path [a, t].

path:
- key: a
- key: t
value:
  list_match:
    one_of:
      string_match:
        exact: m

An example use of StructMatcher is to match metadata in envoy.v*.core.Node.

{
  "path": [],
  "value": "{...}"
}

path: (type.matcher.v3.StructMatcher.PathSegment, REQUIRED) The path to retrieve the Value from the Struct.

value: (type.matcher.v3.ValueMatcher, REQUIRED) The StructMatcher is matched if the value retrieved by path is matched to this value.

type.matcher.v3.StructMatcher.PathSegment¶

[type.matcher.v3.StructMatcher.PathSegment proto]

Specifies the segment in a path to retrieve value from Struct.

{
  "key": "..."
}

key: (string, REQUIRED) If specified, use the key to retrieve the value in a Struct.