go-control-plane: github.com/envoyproxy/go-control-plane/envoy/config/filter/http/transcoder/v2 Index | Files

package envoy_config_filter_http_transcoder_v2

import "github.com/envoyproxy/go-control-plane/envoy/config/filter/http/transcoder/v2"

Index

Package Files

transcoder.pb.go transcoder.pb.validate.go

Variables

var File_envoy_config_filter_http_transcoder_v2_transcoder_proto protoreflect.FileDescriptor

type GrpcJsonTranscoder Uses

type GrpcJsonTranscoder struct {

    // Types that are assignable to DescriptorSet:
    //	*GrpcJsonTranscoder_ProtoDescriptor
    //	*GrpcJsonTranscoder_ProtoDescriptorBin
    DescriptorSet isGrpcJsonTranscoder_DescriptorSet `protobuf_oneof:"descriptor_set"`
    // A list of strings that
    // supplies the fully qualified service names (i.e. "package_name.service_name") that
    // the transcoder will translate. If the service name doesn't exist in ``proto_descriptor``,
    // Envoy will fail at startup. The ``proto_descriptor`` may contain more services than
    // the service names specified here, but they won't be translated.
    Services []string `protobuf:"bytes,2,rep,name=services,proto3" json:"services,omitempty"`
    // Control options for response JSON. These options are passed directly to
    // `JsonPrintOptions <https://developers.google.com/protocol-buffers/docs/reference/cpp/
    // google.protobuf.util.json_util#JsonPrintOptions>`_.
    PrintOptions *GrpcJsonTranscoder_PrintOptions `protobuf:"bytes,3,opt,name=print_options,json=printOptions,proto3" json:"print_options,omitempty"`
    // Whether to keep the incoming request route after the outgoing headers have been transformed to
    // the match the upstream gRPC service. Note: This means that routes for gRPC services that are
    // not transcoded cannot be used in combination with *match_incoming_request_route*.
    MatchIncomingRequestRoute bool `protobuf:"varint,5,opt,name=match_incoming_request_route,json=matchIncomingRequestRoute,proto3" json:"match_incoming_request_route,omitempty"`
    // A list of query parameters to be ignored for transcoding method mapping.
    // By default, the transcoder filter will not transcode a request if there are any
    // unknown/invalid query parameters.
    //
    // Example :
    //
    // .. code-block:: proto
    //
    //     service Bookstore {
    //       rpc GetShelf(GetShelfRequest) returns (Shelf) {
    //         option (google.api.http) = {
    //           get: "/shelves/{shelf}"
    //         };
    //       }
    //     }
    //
    //     message GetShelfRequest {
    //       int64 shelf = 1;
    //     }
    //
    //     message Shelf {}
    //
    // The request ``/shelves/100?foo=bar`` will not be mapped to ``GetShelf``` because variable
    // binding for ``foo`` is not defined. Adding ``foo`` to ``ignored_query_parameters`` will allow
    // the same request to be mapped to ``GetShelf``.
    IgnoredQueryParameters []string `protobuf:"bytes,6,rep,name=ignored_query_parameters,json=ignoredQueryParameters,proto3" json:"ignored_query_parameters,omitempty"`
    // Whether to route methods without the ``google.api.http`` option.
    //
    // Example :
    //
    // .. code-block:: proto
    //
    //     package bookstore;
    //
    //     service Bookstore {
    //       rpc GetShelf(GetShelfRequest) returns (Shelf) {}
    //     }
    //
    //     message GetShelfRequest {
    //       int64 shelf = 1;
    //     }
    //
    //     message Shelf {}
    //
    // The client could ``post`` a json body ``{"shelf": 1234}`` with the path of
    // ``/bookstore.Bookstore/GetShelfRequest`` to call ``GetShelfRequest``.
    AutoMapping bool `protobuf:"varint,7,opt,name=auto_mapping,json=autoMapping,proto3" json:"auto_mapping,omitempty"`
    // Whether to ignore query parameters that cannot be mapped to a corresponding
    // protobuf field. Use this if you cannot control the query parameters and do
    // not know them beforehand. Otherwise use ``ignored_query_parameters``.
    // Defaults to false.
    IgnoreUnknownQueryParameters bool `protobuf:"varint,8,opt,name=ignore_unknown_query_parameters,json=ignoreUnknownQueryParameters,proto3" json:"ignore_unknown_query_parameters,omitempty"`
    // Whether to convert gRPC status headers to JSON.
    // When trailer indicates a gRPC error and there was no HTTP body, take ``google.rpc.Status``
    // from the ``grpc-status-details-bin`` header and use it as JSON body.
    // If there was no such header, make ``google.rpc.Status`` out of the ``grpc-status`` and
    // ``grpc-message`` headers.
    // The error details types must be present in the ``proto_descriptor``.
    //
    // For example, if an upstream server replies with headers:
    //
    // .. code-block:: none
    //
    //     grpc-status: 5
    //     grpc-status-details-bin:
    //         CAUaMwoqdHlwZS5nb29nbGVhcGlzLmNvbS9nb29nbGUucnBjLlJlcXVlc3RJbmZvEgUKA3ItMQ
    //
    // The ``grpc-status-details-bin`` header contains a base64-encoded protobuf message
    // ``google.rpc.Status``. It will be transcoded into:
    //
    // .. code-block:: none
    //
    //     HTTP/1.1 404 Not Found
    //     content-type: application/json
    //
    //     {"code":5,"details":[{"@type":"type.googleapis.com/google.rpc.RequestInfo","requestId":"r-1"}]}
    //
    //  In order to transcode the message, the ``google.rpc.RequestInfo`` type from
    //  the ``google/rpc/error_details.proto`` should be included in the configured
    //  :ref:`proto descriptor set <config_grpc_json_generate_proto_descriptor_set>`.
    ConvertGrpcStatus bool `protobuf:"varint,9,opt,name=convert_grpc_status,json=convertGrpcStatus,proto3" json:"convert_grpc_status,omitempty"`
    // contains filtered or unexported fields
}

[#next-free-field: 10]

func (*GrpcJsonTranscoder) Descriptor Uses

func (*GrpcJsonTranscoder) Descriptor() ([]byte, []int)

Deprecated: Use GrpcJsonTranscoder.ProtoReflect.Descriptor instead.

func (*GrpcJsonTranscoder) GetAutoMapping Uses

func (x *GrpcJsonTranscoder) GetAutoMapping() bool

func (*GrpcJsonTranscoder) GetConvertGrpcStatus Uses

func (x *GrpcJsonTranscoder) GetConvertGrpcStatus() bool

func (*GrpcJsonTranscoder) GetDescriptorSet Uses

func (m *GrpcJsonTranscoder) GetDescriptorSet() isGrpcJsonTranscoder_DescriptorSet

func (*GrpcJsonTranscoder) GetIgnoreUnknownQueryParameters Uses

func (x *GrpcJsonTranscoder) GetIgnoreUnknownQueryParameters() bool

func (*GrpcJsonTranscoder) GetIgnoredQueryParameters Uses

func (x *GrpcJsonTranscoder) GetIgnoredQueryParameters() []string

func (*GrpcJsonTranscoder) GetMatchIncomingRequestRoute Uses

func (x *GrpcJsonTranscoder) GetMatchIncomingRequestRoute() bool

func (*GrpcJsonTranscoder) GetPrintOptions Uses

func (x *GrpcJsonTranscoder) GetPrintOptions() *GrpcJsonTranscoder_PrintOptions

func (*GrpcJsonTranscoder) GetProtoDescriptor Uses

func (x *GrpcJsonTranscoder) GetProtoDescriptor() string

func (*GrpcJsonTranscoder) GetProtoDescriptorBin Uses

func (x *GrpcJsonTranscoder) GetProtoDescriptorBin() []byte

func (*GrpcJsonTranscoder) GetServices Uses

func (x *GrpcJsonTranscoder) GetServices() []string

func (*GrpcJsonTranscoder) ProtoMessage Uses

func (*GrpcJsonTranscoder) ProtoMessage()

func (*GrpcJsonTranscoder) ProtoReflect Uses

func (x *GrpcJsonTranscoder) ProtoReflect() protoreflect.Message

func (*GrpcJsonTranscoder) Reset Uses

func (x *GrpcJsonTranscoder) Reset()

func (*GrpcJsonTranscoder) String Uses

func (x *GrpcJsonTranscoder) String() string

func (*GrpcJsonTranscoder) Validate Uses

func (m *GrpcJsonTranscoder) Validate() error

Validate checks the field values on GrpcJsonTranscoder with the rules defined in the proto definition for this message. If any rules are violated, an error is returned.

type GrpcJsonTranscoderValidationError Uses

type GrpcJsonTranscoderValidationError struct {
    // contains filtered or unexported fields
}

GrpcJsonTranscoderValidationError is the validation error returned by GrpcJsonTranscoder.Validate if the designated constraints aren't met.

func (GrpcJsonTranscoderValidationError) Cause Uses

func (e GrpcJsonTranscoderValidationError) Cause() error

Cause function returns cause value.

func (GrpcJsonTranscoderValidationError) Error Uses

func (e GrpcJsonTranscoderValidationError) Error() string

Error satisfies the builtin error interface

func (GrpcJsonTranscoderValidationError) ErrorName Uses

func (e GrpcJsonTranscoderValidationError) ErrorName() string

ErrorName returns error name.

func (GrpcJsonTranscoderValidationError) Field Uses

func (e GrpcJsonTranscoderValidationError) Field() string

Field function returns field value.

func (GrpcJsonTranscoderValidationError) Key Uses

func (e GrpcJsonTranscoderValidationError) Key() bool

Key function returns key value.

func (GrpcJsonTranscoderValidationError) Reason Uses

func (e GrpcJsonTranscoderValidationError) Reason() string

Reason function returns reason value.

type GrpcJsonTranscoder_PrintOptions Uses

type GrpcJsonTranscoder_PrintOptions struct {

    // Whether to add spaces, line breaks and indentation to make the JSON
    // output easy to read. Defaults to false.
    AddWhitespace bool `protobuf:"varint,1,opt,name=add_whitespace,json=addWhitespace,proto3" json:"add_whitespace,omitempty"`
    // Whether to always print primitive fields. By default primitive
    // fields with default values will be omitted in JSON output. For
    // example, an int32 field set to 0 will be omitted. Setting this flag to
    // true will override the default behavior and print primitive fields
    // regardless of their values. Defaults to false.
    AlwaysPrintPrimitiveFields bool `protobuf:"varint,2,opt,name=always_print_primitive_fields,json=alwaysPrintPrimitiveFields,proto3" json:"always_print_primitive_fields,omitempty"`
    // Whether to always print enums as ints. By default they are rendered
    // as strings. Defaults to false.
    AlwaysPrintEnumsAsInts bool `protobuf:"varint,3,opt,name=always_print_enums_as_ints,json=alwaysPrintEnumsAsInts,proto3" json:"always_print_enums_as_ints,omitempty"`
    // Whether to preserve proto field names. By default protobuf will
    // generate JSON field names using the ``json_name`` option, or lower camel case,
    // in that order. Setting this flag will preserve the original field names. Defaults to false.
    PreserveProtoFieldNames bool `protobuf:"varint,4,opt,name=preserve_proto_field_names,json=preserveProtoFieldNames,proto3" json:"preserve_proto_field_names,omitempty"`
    // contains filtered or unexported fields
}

func (*GrpcJsonTranscoder_PrintOptions) Descriptor Uses

func (*GrpcJsonTranscoder_PrintOptions) Descriptor() ([]byte, []int)

Deprecated: Use GrpcJsonTranscoder_PrintOptions.ProtoReflect.Descriptor instead.

func (*GrpcJsonTranscoder_PrintOptions) GetAddWhitespace Uses

func (x *GrpcJsonTranscoder_PrintOptions) GetAddWhitespace() bool

func (*GrpcJsonTranscoder_PrintOptions) GetAlwaysPrintEnumsAsInts Uses

func (x *GrpcJsonTranscoder_PrintOptions) GetAlwaysPrintEnumsAsInts() bool

func (*GrpcJsonTranscoder_PrintOptions) GetAlwaysPrintPrimitiveFields Uses

func (x *GrpcJsonTranscoder_PrintOptions) GetAlwaysPrintPrimitiveFields() bool

func (*GrpcJsonTranscoder_PrintOptions) GetPreserveProtoFieldNames Uses

func (x *GrpcJsonTranscoder_PrintOptions) GetPreserveProtoFieldNames() bool

func (*GrpcJsonTranscoder_PrintOptions) ProtoMessage Uses

func (*GrpcJsonTranscoder_PrintOptions) ProtoMessage()

func (*GrpcJsonTranscoder_PrintOptions) ProtoReflect Uses

func (x *GrpcJsonTranscoder_PrintOptions) ProtoReflect() protoreflect.Message

func (*GrpcJsonTranscoder_PrintOptions) Reset Uses

func (x *GrpcJsonTranscoder_PrintOptions) Reset()

func (*GrpcJsonTranscoder_PrintOptions) String Uses

func (x *GrpcJsonTranscoder_PrintOptions) String() string

func (*GrpcJsonTranscoder_PrintOptions) Validate Uses

func (m *GrpcJsonTranscoder_PrintOptions) Validate() error

Validate checks the field values on GrpcJsonTranscoder_PrintOptions with the rules defined in the proto definition for this message. If any rules are violated, an error is returned.

type GrpcJsonTranscoder_PrintOptionsValidationError Uses

type GrpcJsonTranscoder_PrintOptionsValidationError struct {
    // contains filtered or unexported fields
}

GrpcJsonTranscoder_PrintOptionsValidationError is the validation error returned by GrpcJsonTranscoder_PrintOptions.Validate if the designated constraints aren't met.

func (GrpcJsonTranscoder_PrintOptionsValidationError) Cause Uses

func (e GrpcJsonTranscoder_PrintOptionsValidationError) Cause() error

Cause function returns cause value.

func (GrpcJsonTranscoder_PrintOptionsValidationError) Error Uses

func (e GrpcJsonTranscoder_PrintOptionsValidationError) Error() string

Error satisfies the builtin error interface

func (GrpcJsonTranscoder_PrintOptionsValidationError) ErrorName Uses

func (e GrpcJsonTranscoder_PrintOptionsValidationError) ErrorName() string

ErrorName returns error name.

func (GrpcJsonTranscoder_PrintOptionsValidationError) Field Uses

func (e GrpcJsonTranscoder_PrintOptionsValidationError) Field() string

Field function returns field value.

func (GrpcJsonTranscoder_PrintOptionsValidationError) Key Uses

func (e GrpcJsonTranscoder_PrintOptionsValidationError) Key() bool

Key function returns key value.

func (GrpcJsonTranscoder_PrintOptionsValidationError) Reason Uses

func (e GrpcJsonTranscoder_PrintOptionsValidationError) Reason() string

Reason function returns reason value.

type GrpcJsonTranscoder_ProtoDescriptor Uses

type GrpcJsonTranscoder_ProtoDescriptor struct {
    // Supplies the filename of
    // :ref:`the proto descriptor set <config_grpc_json_generate_proto_descriptor_set>` for the gRPC
    // services.
    ProtoDescriptor string `protobuf:"bytes,1,opt,name=proto_descriptor,json=protoDescriptor,proto3,oneof"`
}

type GrpcJsonTranscoder_ProtoDescriptorBin Uses

type GrpcJsonTranscoder_ProtoDescriptorBin struct {
    // Supplies the binary content of
    // :ref:`the proto descriptor set <config_grpc_json_generate_proto_descriptor_set>` for the gRPC
    // services.
    ProtoDescriptorBin []byte `protobuf:"bytes,4,opt,name=proto_descriptor_bin,json=protoDescriptorBin,proto3,oneof"`
}

Package envoy_config_filter_http_transcoder_v2 imports 18 packages (graph) and is imported by 8 packages. Updated 2021-01-07. Refresh now. Tools for package owners.