package xds.type.v3

Get desktop application:
View/edit binary Protocol Buffers messages

Either parsed or checked representation of the `Common Expression Language <https://github.com/google/cel-spec>`_ (CEL) program.

Used in: envoy.extensions.tracers.opentelemetry.samplers.v3.CELSamplerConfig, matcher.v3.CelMatcher, CelExtractString

• oneof expr_specifier

  • google.api.expr.v1alpha1.ParsedExpr parsed_expr = 1

    Parsed expression in abstract syntax tree (AST) form. Deprecated -- use ``cel_expr_parsed`` field instead. If ``cel_expr_parsed`` or ``cel_expr_checked`` is set, this field is not used.

  • google.api.expr.v1alpha1.CheckedExpr checked_expr = 2

    Parsed expression in abstract syntax tree (AST) form that has been successfully type checked. Deprecated -- use ``cel_expr_checked`` field instead. If ``cel_expr_parsed`` or ``cel_expr_checked`` is set, this field is not used.

• optional cel.expr.ParsedExpr cel_expr_parsed = 3

  Parsed expression in abstract syntax tree (AST) form. If ``cel_expr_checked`` is set, this field is not used.

• optional cel.expr.CheckedExpr cel_expr_checked = 4

  Parsed expression in abstract syntax tree (AST) form that has been successfully type checked. If set, takes precedence over ``cel_expr_parsed``.

Extracts a string by evaluating a `Common Expression Language <https://github.com/google/cel-spec>`_ (CEL) expression against the standardized set of :ref:`HTTP attributes <arch_overview_attributes>`. .. attention:: Besides CEL evaluation raising an error explicitly, CEL program returning a type other than the ``string``, or not returning anything, are considered an error as well. [#comment:TODO(sergiitk): When implemented, add the extension tag.]

• optional CelExpression expr_extract = 1

  The CEL expression used to extract a string from the CEL environment. the "subject string") that should be replaced.

• optional google.protobuf.StringValue default_value = 2

  If CEL expression evaluates to an error, this value is be returned to the caller. If not set, the error is propagated to the caller.

Specifies the double start and end of the range using half-open interval semantics [start, end).

Used in: matcher.v3.DoubleRangeMatcher.RangeMatcher

• double start = 1

  start of the range (inclusive)

• double end = 2

  end of the range (exclusive)

Specifies the int32 start and end of the range using half-open interval semantics [start, end).

Used in: matcher.v3.Int32RangeMatcher.RangeMatcher

• int32 start = 1

  start of the range (inclusive)

• int32 end = 2

  end of the range (exclusive)

Specifies the int64 start and end of the range using half-open interval semantics [start, end).

Used in: matcher.v3.Int64RangeMatcher.RangeMatcher

• int64 start = 1

  start of the range (inclusive)

• int64 end = 2

  end of the range (exclusive)

A TypedStruct contains an arbitrary JSON serialized protocol buffer message with a URL that describes the type of the serialized message. This is very similar to google.protobuf.Any, instead of having protocol buffer binary, this employs google.protobuf.Struct as value. This message is intended to be embedded inside Any, so it shouldn't be directly referred from other UDPA messages. When packing an opaque extension config, packing the expected type into Any is preferred wherever possible for its efficiency. TypedStruct should be used only if a proto descriptor is not available, for example if: - A control plane sends opaque message that is originally from external source in human readable format such as JSON or YAML. - The control plane doesn't have the knowledge of the protocol buffer schema hence it cannot serialize the message in protocol buffer binary format. - The DPLB doesn't have have the knowledge of the protocol buffer schema its plugin or extension uses. This has to be indicated in the DPLB capability negotiation. When a DPLB receives a TypedStruct in Any, it should: - Check if the type_url of the TypedStruct matches the type the extension expects. - Convert value to the type described in type_url and perform validation. TODO(lizan): Figure out how TypeStruct should be used with DPLB extensions that doesn't link protobuf descriptor with DPLB itself, (e.g. gRPC LB Plugin, Envoy WASM extensions).

• string type_url = 1

  A URL that uniquely identifies the type of the serialize protocol buffer message. This has same semantics and format described in google.protobuf.Any: https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/any.proto

• optional google.protobuf.Struct value = 2

  A JSON representation of the above specified type.