Skip to content





Upstream represents a destination for routing. Upstreams can be compared to clusters in Envoy terminology. Upstreams can take a variety of types<!--(TODO)--> in gloo. Language extensions known as plugins<!--(TODO)--> allow the addition of new types of upstreams. <!--See upstream types for a detailed description of available upstream types.-->

name: string
type: string
connection_timeout: {google.protobuf.Duration}
spec: {google.protobuf.Struct}
functions: [{Function}]
service_info: {ServiceInfo}
status: (read only)
metadata: {Metadata}

Field Type Label Description
name string Name of the upstream. Names must be unique and follow the following syntax rules: One or more lowercase rfc1035/rfc1123 labels separated by '.' with a maximum length of 253 characters.
type string Type indicates the type of the upstream. Examples include static<!--(TODO)-->, kubernetes<!--(TODO)-->, and aws Types are defined by the plugin<!--(TODO)--> associated with them.
connection_timeout google.protobuf.Duration Connection Timeout tells gloo to set a timeout for unresponsive connections created to this upstream. If not provided by the user, it will set to a default value
spec google.protobuf.Struct Spec contains properties that are specific to the upstream type. The spec is always required, but the expected content is specified by the [upstream plugin] for the given upstream type. Most often the upstream spec will be a map<string, string>
functions Function repeated Certain upstream types support (and may require) functions. Functions allow function-level routing to be done. For example, the AWS lambda upstream type Permits routing to AWS lambda function]. routes on virtualservices can specify function destinations to route to specific functions.
service_info ServiceInfo Service Info contains information about the service running on the upstream Service Info is optional, but is used by certain plugins (such as the gRPC plugin) as well as discovery services to provide sophistocated routing features for well-known types of services
status Status Status indicates the validation status of the upstream resource. Status is read-only by clients, and set by gloo during validation
metadata Metadata Metadata contains the resource metadata for the upstream


type: string
properties: {google.protobuf.Struct}

Field Type Label Description
type string Type indicates the type of service running on the upstream. Current options include REST, gRPC, and NATS
properties google.protobuf.Struct Properties contains properties that describe the service. The spec may be required by the Upstream Plugin that handles the given Service Type Most often the service properties will be a map<string, string>


name: string
spec: {google.protobuf.Struct}

Field Type Label Description
name string Name of the function. Functions are referenced by name from routes and therefore must be unique within an upstream
spec google.protobuf.Struct Spec for the function. Like upstream specs, the content of function specs is specified by the upstream plugin for the upstream's type.