元数据 (proto)

type.metadata.v3.MetadataKey

MetadataKey 使用 key 和 path 提供一个通用接口，用于从 Metadata 中检索值。

例如，对于以下元数据

filter_metadata:
  envoy.xxx:
    prop:
      foo: bar
      xyz:
        hello: envoy

以下 MetadataKey 将从元数据中检索字符串值“bar”。

key: envoy.xxx
path:
- key: prop
- key: foo

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

path

(重复 type.metadata.v3.MetadataKey.PathSegment, 必需) 从 Struct 中检索值的路径。它可以是前缀或完整路径，例如 [prop, xyz] 用于结构，或 [prop, foo] 用于示例中的字符串，这取决于特定情况。

注意：由于只支持键类型段，因此路径不能指定列表，除非列表是最后一个段。

指定路径中从元数据检索值的段。目前只支持指定键，即字段名，作为路径的一个段。

{
  "key": ...
}

描述元数据的类型。

{
  "request": {...},
  "route": {...},
  "cluster": {...},
  "host": {...}
}

request

(type.metadata.v3.MetadataKind.Request) 请求类型的元数据。

必须设置 request、route、cluster、host 中的其中一个。

route

(type.metadata.v3.MetadataKind.Route) 路由类型的元数据。

必须设置 request、route、cluster、host 中的其中一个。

cluster

(type.metadata.v3.MetadataKind.Cluster) 集群类型的元数据。

必须设置 request、route、cluster、host 中的其中一个。

host

(type.metadata.v3.MetadataKind.Host) 主机类型的元数据。

必须设置 request、route、cluster、host 中的其中一个。

表示与请求相关的动态元数据。

表示来自路由的元数据。

表示来自上游集群的元数据。

表示来自上游主机的元数据。