Documentation
¶
Index ¶
- Variables
- type HttpProtocolOptions
- func (*HttpProtocolOptions) Descriptor() ([]byte, []int)deprecated
- func (x *HttpProtocolOptions) GetCommonHttpProtocolOptions() *v3.HttpProtocolOptions
- func (x *HttpProtocolOptions) GetExplicitHttpConfig() *HttpProtocolOptions_ExplicitHttpConfig
- func (x *HttpProtocolOptions) GetUpstreamHttpProtocolOptions() *v3.UpstreamHttpProtocolOptions
- func (m *HttpProtocolOptions) GetUpstreamProtocolOptions() isHttpProtocolOptions_UpstreamProtocolOptions
- func (x *HttpProtocolOptions) GetUseDownstreamProtocolConfig() *HttpProtocolOptions_UseDownstreamHttpConfig
- func (*HttpProtocolOptions) ProtoMessage()
- func (x *HttpProtocolOptions) ProtoReflect() protoreflect.Message
- func (x *HttpProtocolOptions) Reset()
- func (x *HttpProtocolOptions) String() string
- func (m *HttpProtocolOptions) Validate() error
- type HttpProtocolOptionsValidationError
- func (e HttpProtocolOptionsValidationError) Cause() error
- func (e HttpProtocolOptionsValidationError) Error() string
- func (e HttpProtocolOptionsValidationError) ErrorName() string
- func (e HttpProtocolOptionsValidationError) Field() string
- func (e HttpProtocolOptionsValidationError) Key() bool
- func (e HttpProtocolOptionsValidationError) Reason() string
- type HttpProtocolOptions_ExplicitHttpConfig
- func (*HttpProtocolOptions_ExplicitHttpConfig) Descriptor() ([]byte, []int)deprecated
- func (x *HttpProtocolOptions_ExplicitHttpConfig) GetHttp2ProtocolOptions() *v3.Http2ProtocolOptions
- func (x *HttpProtocolOptions_ExplicitHttpConfig) GetHttpProtocolOptions() *v3.Http1ProtocolOptions
- func (m *HttpProtocolOptions_ExplicitHttpConfig) GetProtocolConfig() isHttpProtocolOptions_ExplicitHttpConfig_ProtocolConfig
- func (*HttpProtocolOptions_ExplicitHttpConfig) ProtoMessage()
- func (x *HttpProtocolOptions_ExplicitHttpConfig) ProtoReflect() protoreflect.Message
- func (x *HttpProtocolOptions_ExplicitHttpConfig) Reset()
- func (x *HttpProtocolOptions_ExplicitHttpConfig) String() string
- func (m *HttpProtocolOptions_ExplicitHttpConfig) Validate() error
- type HttpProtocolOptions_ExplicitHttpConfigValidationError
- func (e HttpProtocolOptions_ExplicitHttpConfigValidationError) Cause() error
- func (e HttpProtocolOptions_ExplicitHttpConfigValidationError) Error() string
- func (e HttpProtocolOptions_ExplicitHttpConfigValidationError) ErrorName() string
- func (e HttpProtocolOptions_ExplicitHttpConfigValidationError) Field() string
- func (e HttpProtocolOptions_ExplicitHttpConfigValidationError) Key() bool
- func (e HttpProtocolOptions_ExplicitHttpConfigValidationError) Reason() string
- type HttpProtocolOptions_ExplicitHttpConfig_
- type HttpProtocolOptions_ExplicitHttpConfig_Http2ProtocolOptions
- type HttpProtocolOptions_ExplicitHttpConfig_HttpProtocolOptions
- type HttpProtocolOptions_UseDownstreamHttpConfig
- func (*HttpProtocolOptions_UseDownstreamHttpConfig) Descriptor() ([]byte, []int)deprecated
- func (x *HttpProtocolOptions_UseDownstreamHttpConfig) GetHttp2ProtocolOptions() *v3.Http2ProtocolOptions
- func (x *HttpProtocolOptions_UseDownstreamHttpConfig) GetHttpProtocolOptions() *v3.Http1ProtocolOptions
- func (*HttpProtocolOptions_UseDownstreamHttpConfig) ProtoMessage()
- func (x *HttpProtocolOptions_UseDownstreamHttpConfig) ProtoReflect() protoreflect.Message
- func (x *HttpProtocolOptions_UseDownstreamHttpConfig) Reset()
- func (x *HttpProtocolOptions_UseDownstreamHttpConfig) String() string
- func (m *HttpProtocolOptions_UseDownstreamHttpConfig) Validate() error
- type HttpProtocolOptions_UseDownstreamHttpConfigValidationError
- func (e HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Cause() error
- func (e HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Error() string
- func (e HttpProtocolOptions_UseDownstreamHttpConfigValidationError) ErrorName() string
- func (e HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Field() string
- func (e HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Key() bool
- func (e HttpProtocolOptions_UseDownstreamHttpConfigValidationError) Reason() string
- type HttpProtocolOptions_UseDownstreamProtocolConfig
Constants ¶
This section is empty.
Variables ¶
var File_envoy_extensions_upstreams_http_v3_http_protocol_options_proto protoreflect.FileDescriptor
Functions ¶
This section is empty.
Types ¶
type HttpProtocolOptions ¶
type HttpProtocolOptions struct {
// This contains options common across HTTP/1 and HTTP/2
CommonHttpProtocolOptions *v3.HttpProtocolOptions `` /* 140-byte string literal not displayed */
// This contains common protocol options which are only applied upstream.
UpstreamHttpProtocolOptions *v3.UpstreamHttpProtocolOptions `` /* 146-byte string literal not displayed */
// 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
deprecated
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
deprecated
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
deprecated
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"`
}