package envoy_extensions_upstreams_http_v3

import "github.com/envoyproxy/go-control-plane/envoy/extensions/upstreams/http/v3"

Index

Variables 

var File_envoy_extensions_upstreams_http_v3_http_protocol_options_proto protoreflect.FileDescriptor

Types

type HttpProtocolOptions 

type HttpProtocolOptions struct {

	// This contains options common across HTTP/1 and HTTP/2
	CommonHttpProtocolOptions *v3.HttpProtocolOptions `protobuf:"bytes,1,opt,name=common_http_protocol_options,json=commonHttpProtocolOptions,proto3" json:"common_http_protocol_options,omitempty"`
	// This contains common protocol options which are only applied upstream.
	UpstreamHttpProtocolOptions *v3.UpstreamHttpProtocolOptions `protobuf:"bytes,2,opt,name=upstream_http_protocol_options,json=upstreamHttpProtocolOptions,proto3" json:"upstream_http_protocol_options,omitempty"`
	// This controls the actual protocol to be used upstream.
	// If none of the *upstream_protocol_options* are chosen, the default is *explicit_http_config*.
	//
	// Types that are assignable to UpstreamProtocolOptions:
	//	*HttpProtocolOptions_ExplicitHttpConfig_
	//	*HttpProtocolOptions_UseDownstreamProtocolConfig
	UpstreamProtocolOptions isHttpProtocolOptions_UpstreamProtocolOptions `protobuf_oneof:"upstream_protocol_options"`
	// contains filtered or unexported fields
}

HttpProtocolOptions specifies Http upstream protocol options. This object is used in :ref:`typed_extension_protocol_options<envoy_api_field_config.cluster.v3.Cluster.typed_extension_protocol_options>`, keyed by the name `envoy.extensions.upstreams.http.v3.HttpProtocolOptions`.

This controls what protocol(s) should be used for upstream and how said protocol(s) are configured.

This replaces the prior pattern of explicit protocol configuration directly in the cluster. So a configuration like this, explicitly configuring the use of HTTP/2 upstream:

.. code:: 

clusters:
  - name: some_service
    connect_timeout: 5s
    upstream_http_protocol_options:
      auto_sni: true
    common_http_protocol_options:
      idle_timeout: 1s
    http2_protocol_options:
      max_concurrent_streams: 100
     .... [further cluster config]

Would now look like this:

.. code:: 

clusters:
  - name: some_service
    connect_timeout: 5s
    typed_extension_protocol_options:
      envoy.extensions.upstreams.http.v3.HttpProtocolOptions:
        "@type": type.googleapis.com/envoy.extensions.upstreams.http.v3.HttpProtocolOptions
        upstream_http_protocol_options:
          auto_sni: true
        common_http_protocol_options:
          idle_timeout: 1s
        explicit_http_config:
          http2_protocol_options:
            max_concurrent_streams: 100
     .... [further cluster config]

func (*HttpProtocolOptions) Descriptor 

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

Deprecated: Use HttpProtocolOptions.ProtoReflect.Descriptor instead.

func (*HttpProtocolOptions) GetCommonHttpProtocolOptions 

func (x *HttpProtocolOptions) GetCommonHttpProtocolOptions() *v3.HttpProtocolOptions

func (*HttpProtocolOptions) GetExplicitHttpConfig 

func (x *HttpProtocolOptions) GetExplicitHttpConfig() *HttpProtocolOptions_ExplicitHttpConfig

func (*HttpProtocolOptions) GetUpstreamHttpProtocolOptions 

func (x *HttpProtocolOptions) GetUpstreamHttpProtocolOptions() *v3.UpstreamHttpProtocolOptions

func (*HttpProtocolOptions) GetUpstreamProtocolOptions 

func (m *HttpProtocolOptions) GetUpstreamProtocolOptions() isHttpProtocolOptions_UpstreamProtocolOptions

func (*HttpProtocolOptions) GetUseDownstreamProtocolConfig 

func (x *HttpProtocolOptions) GetUseDownstreamProtocolConfig() *HttpProtocolOptions_UseDownstreamHttpConfig

func (*HttpProtocolOptions) ProtoMessage 

func (*HttpProtocolOptions) ProtoMessage()

func (*HttpProtocolOptions) ProtoReflect 

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

func (*HttpProtocolOptions) Reset 

func (x *HttpProtocolOptions) Reset()

func (*HttpProtocolOptions) String 

func (x *HttpProtocolOptions) String() string

func (*HttpProtocolOptions) Validate 

func (m *HttpProtocolOptions) Validate() error

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

type HttpProtocolOptionsValidationError 

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

HttpProtocolOptionsValidationError is the validation error returned by HttpProtocolOptions.Validate if the designated constraints aren't met.

func (HttpProtocolOptionsValidationError) Cause 

func (e HttpProtocolOptionsValidationError) Cause() error

Cause function returns cause value.

func (HttpProtocolOptionsValidationError) Error 

func (e HttpProtocolOptionsValidationError) Error() string

Error satisfies the builtin error interface

func (HttpProtocolOptionsValidationError) ErrorName 

func (e HttpProtocolOptionsValidationError) ErrorName() string

ErrorName returns error name.

func (HttpProtocolOptionsValidationError) Field 

func (e HttpProtocolOptionsValidationError) Field() string

Field function returns field value.

func (HttpProtocolOptionsValidationError) Key 

func (e HttpProtocolOptionsValidationError) Key() bool

Key function returns key value.

func (HttpProtocolOptionsValidationError) Reason 

func (e HttpProtocolOptionsValidationError) Reason() string

Reason function returns reason value.

type HttpProtocolOptions_ExplicitHttpConfig 

type HttpProtocolOptions_ExplicitHttpConfig struct {

	// Types that are assignable to ProtocolConfig:
	//	*HttpProtocolOptions_ExplicitHttpConfig_HttpProtocolOptions
	//	*HttpProtocolOptions_ExplicitHttpConfig_Http2ProtocolOptions
	ProtocolConfig isHttpProtocolOptions_ExplicitHttpConfig_ProtocolConfig `protobuf_oneof:"protocol_config"`
	// contains filtered or unexported fields
}

If this is used, the cluster will only operate on one of the possible upstream protocols (HTTP/1.1, HTTP/2). If :ref:`http2_protocol_options <envoy_api_field_config.cluster.v3.Cluster.http2_protocol_options>` are present, HTTP2 will be used, otherwise HTTP1.1 will be used.

func (*HttpProtocolOptions_ExplicitHttpConfig) Descriptor 

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

Deprecated: Use HttpProtocolOptions_ExplicitHttpConfig.ProtoReflect.Descriptor instead.

func (*HttpProtocolOptions_ExplicitHttpConfig) GetHttp2ProtocolOptions 

func (x *HttpProtocolOptions_ExplicitHttpConfig) GetHttp2ProtocolOptions() *v3.Http2ProtocolOptions

func (*HttpProtocolOptions_ExplicitHttpConfig) GetHttpProtocolOptions 

func (x *HttpProtocolOptions_ExplicitHttpConfig) GetHttpProtocolOptions() *v3.Http1ProtocolOptions

func (*HttpProtocolOptions_ExplicitHttpConfig) GetProtocolConfig 

func (m *HttpProtocolOptions_ExplicitHttpConfig) GetProtocolConfig() isHttpProtocolOptions_ExplicitHttpConfig_ProtocolConfig

func (*HttpProtocolOptions_ExplicitHttpConfig) ProtoMessage 

func (*HttpProtocolOptions_ExplicitHttpConfig) ProtoMessage()

func (*HttpProtocolOptions_ExplicitHttpConfig) ProtoReflect 

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

func (*HttpProtocolOptions_ExplicitHttpConfig) Reset 

func (x *HttpProtocolOptions_ExplicitHttpConfig) Reset()

func (*HttpProtocolOptions_ExplicitHttpConfig) String 

func (x *HttpProtocolOptions_ExplicitHttpConfig) String() string

func (*HttpProtocolOptions_ExplicitHttpConfig) Validate 

func (m *HttpProtocolOptions_ExplicitHttpConfig) Validate() error

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

type HttpProtocolOptions_ExplicitHttpConfigValidationError 

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

HttpProtocolOptions_ExplicitHttpConfigValidationError is the validation error returned by HttpProtocolOptions_ExplicitHttpConfig.Validate if the designated constraints aren't met.

func (HttpProtocolOptions_ExplicitHttpConfigValidationError) Cause 

func (e HttpProtocolOptions_ExplicitHttpConfigValidationError) Cause() error

Cause function returns cause value.

func (HttpProtocolOptions_ExplicitHttpConfigValidationError) Error 

func (e HttpProtocolOptions_ExplicitHttpConfigValidationError) Error() string

Error satisfies the builtin error interface

func (HttpProtocolOptions_ExplicitHttpConfigValidationError) ErrorName 

func (e HttpProtocolOptions_ExplicitHttpConfigValidationError) ErrorName() string

ErrorName returns error name.

func (HttpProtocolOptions_ExplicitHttpConfigValidationError) Field 

func (e HttpProtocolOptions_ExplicitHttpConfigValidationError) Field() string

Field function returns field value.

func (HttpProtocolOptions_ExplicitHttpConfigValidationError) Key 

func (e HttpProtocolOptions_ExplicitHttpConfigValidationError) Key() bool

Key function returns key value.

func (HttpProtocolOptions_ExplicitHttpConfigValidationError) Reason 

func (e HttpProtocolOptions_ExplicitHttpConfigValidationError) Reason() string

Reason function returns reason value.

type HttpProtocolOptions_ExplicitHttpConfig_ 

type HttpProtocolOptions_ExplicitHttpConfig_ struct {
	// To explicitly configure either HTTP/1 or HTTP/2 (but not both!) use *explicit_http_config*.
	// If the *explicit_http_config* is empty, HTTP/1.1 is used.
	ExplicitHttpConfig *HttpProtocolOptions_ExplicitHttpConfig `protobuf:"bytes,3,opt,name=explicit_http_config,json=explicitHttpConfig,proto3,oneof"`
}

type HttpProtocolOptions_ExplicitHttpConfig_Http2ProtocolOptions 

type HttpProtocolOptions_ExplicitHttpConfig_Http2ProtocolOptions struct {
	Http2ProtocolOptions *v3.Http2ProtocolOptions `protobuf:"bytes,2,opt,name=http2_protocol_options,json=http2ProtocolOptions,proto3,oneof"`
}

type HttpProtocolOptions_ExplicitHttpConfig_HttpProtocolOptions 

type HttpProtocolOptions_ExplicitHttpConfig_HttpProtocolOptions struct {
	HttpProtocolOptions *v3.Http1ProtocolOptions `protobuf:"bytes,1,opt,name=http_protocol_options,json=httpProtocolOptions,proto3,oneof"`
}

type HttpProtocolOptions_UseDownstreamHttpConfig 

type HttpProtocolOptions_UseDownstreamHttpConfig struct {
	HttpProtocolOptions  *v3.Http1ProtocolOptions `protobuf:"bytes,1,opt,name=http_protocol_options,json=httpProtocolOptions,proto3" json:"http_protocol_options,omitempty"`
	Http2ProtocolOptions *v3.Http2ProtocolOptions `protobuf:"bytes,2,opt,name=http2_protocol_options,json=http2ProtocolOptions,proto3" json:"http2_protocol_options,omitempty"`
	// contains filtered or unexported fields
}

If this is used, the cluster can use either of the configured protocols, and will use whichever protocol was used by the downstream connection.

func (*HttpProtocolOptions_UseDownstreamHttpConfig) Descriptor 

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

Deprecated: Use HttpProtocolOptions_UseDownstreamHttpConfig.ProtoReflect.Descriptor instead.

func (*HttpProtocolOptions_UseDownstreamHttpConfig) GetHttp2ProtocolOptions 

func (x *HttpProtocolOptions_UseDownstreamHttpConfig) GetHttp2ProtocolOptions() *v3.Http2ProtocolOptions

func (*HttpProtocolOptions_UseDownstreamHttpConfig) GetHttpProtocolOptions 

func (x *HttpProtocolOptions_UseDownstreamHttpConfig) GetHttpProtocolOptions() *v3.Http1ProtocolOptions

func (*HttpProtocolOptions_UseDownstreamHttpConfig) ProtoMessage 

func (*HttpProtocolOptions_UseDownstreamHttpConfig) ProtoMessage()

func (*HttpProtocolOptions_UseDownstreamHttpConfig) ProtoReflect 

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

func (*HttpProtocolOptions_UseDownstreamHttpConfig) Reset 

func (x *HttpProtocolOptions_UseDownstreamHttpConfig) Reset()

func (*HttpProtocolOptions_UseDownstreamHttpConfig) String 

func (x *HttpProtocolOptions_UseDownstreamHttpConfig) String() string

func (*HttpProtocolOptions_UseDownstreamHttpConfig) Validate 

func (m *HttpProtocolOptions_UseDownstreamHttpConfig) Validate() error

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

type HttpProtocolOptions_UseDownstreamHttpConfigValidationError 

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

HttpProtocolOptions_UseDownstreamHttpConfigValidationError is the validation error returned by HttpProtocolOptions_UseDownstreamHttpConfig.Validate if the designated constraints aren't met.

func (HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Cause 

func (e HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Cause() error

Cause function returns cause value.

func (HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Error 

func (e HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Error() string

Error satisfies the builtin error interface

func (HttpProtocolOptions_UseDownstreamHttpConfigValidationError) ErrorName 

func (e HttpProtocolOptions_UseDownstreamHttpConfigValidationError) ErrorName() string

ErrorName returns error name.

func (HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Field 

func (e HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Field() string

Field function returns field value.

func (HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Key 

func (e HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Key() bool

Key function returns key value.

func (HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Reason 

func (e HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Reason() string

Reason function returns reason value.

type HttpProtocolOptions_UseDownstreamProtocolConfig 

type HttpProtocolOptions_UseDownstreamProtocolConfig struct {
	// This allows switching on protocol based on what protocol the downstream
	// connection used.
	UseDownstreamProtocolConfig *HttpProtocolOptions_UseDownstreamHttpConfig `protobuf:"bytes,4,opt,name=use_downstream_protocol_config,json=useDownstreamProtocolConfig,proto3,oneof"`
}

Source Files

http_protocol_options.pb.go http_protocol_options.pb.validate.go

Version
v0.9.8
Published
Dec 7, 2020
Platform
darwin/amd64
Imports
18 packages
Last checked
1 hour ago –

Tools for package owners.