Http Route
HttpRoute
Defines the high-level intent for routing HTTP(S) traffic.
The engine turns it into mesh routes or load balancer URL maps. It supports path-based routing, header manipulation, and traffic splitting.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be HttpRoute. |
| metadata | map | Free-form key/value labels. The engine reads reserved keys (for example name, project) to resolve the identity of this manifest and its parent ingress (PublicIngress or PrivateIngress). |
| spec | Spec | Desired HTTP route configuration. See Spec. |
Target
Resolved backend target of the route.
Set when a rule destination targets an Agent (kind AGENT). Informational: the executor does not read it yet.
| Property | Type | Description |
|---|---|---|
| kind | string | Target resource kind, for example AGENT. |
| name | string | Name of the resolved backend target manifest. |
Spec
User-defined HTTP routing rules.
The engine turns the rules into mesh route rules and load-balancer URL-map paths on the parent ingress.
| Property | Type | Description |
|---|---|---|
| description | string | Optional free text. It appears in generated documentation, and AI assistants use it as context. The engine does not use it otherwise. |
| rules | list of HttpRouteRule | Ordered list of rules. See HttpRouteRule. Each rule becomes a mesh route rule and load-balancer URL-map paths on the parent ingress, bound to a hostname from the manifest name. The engine reorders rules by match specificity, so more specific matches win. |
| ingressPath | string | Path from the public load balancer to the destination: MESH or DIRECT. If empty, the engine uses MESH. |
| directReason | string | NOT RECOMMENDED. Reason why this route skips the mesh gateway. Use it only with ingress_path DIRECT. A DIRECT route is not the recommended secure way to expose a service. Use MESH, which is the default. Use DIRECT only for a service that checks bearer tokens itself and needs the original Authorization header. |
HttpRouteRule
HTTP routing rule.
Pairs match conditions with an action.
| Property | Type | Description |
|---|---|---|
| matches | list of HttpRouteRuleMatch | Conditions that select requests for this rule. A request matches if any condition holds. |
| authentication | list of RouteRuleAuthenticationConfig | Authentication configuration. If not set, the rule needs no authentication. |
| authorization | list of ComputedAuthorizationAccessRuleCheck | Authorization configuration. If not set, the rule is open to all users. |
ComputedAuthorizationAccessRuleCheck
Computed access check for a route rule.
The identity tuple (namespace, relation, object) that the authorization extension checks.
| Property | Type | Description |
|---|---|---|
| namespace | string | Copy of spec.authorization.namespace of the child HttpRoute or GrpcRoute manifest. |
| relation | string | Copy of spec.authorization.relation of the child HttpRoute or GrpcRoute manifest. |
| object | string | Copy of spec.authorization.object of the child HttpRoute or GrpcRoute manifest. |
RouteRuleAuthenticationConfig
Authentication exceptions for a route rule.
Sets how authentication works for the paths that the rule matches.
| Property | Type | Description |
|---|---|---|
| type | string | IDENTITY_PROVIDER limits access to the identity providers in tenants. INTERNAL limits access to internal callers. Validation checks it against the declared identity providers. |
| tenants | list of string | IdentityProvider names that can access this route. Only for type IDENTITY_PROVIDER. Each entry must reference a provider that exists. |
HttpRouteRuleMatch
Match criteria for an HTTP request.
Selects requests by path, header or query parameter.
| Property | Type | Description |
|---|---|---|
| ignoreCase | bool | If true, path comparisons ignore case. |
| fullPathMatch | string | Matches if the request path equals this value. Mutually exclusive with prefix_match and regex_match. |
| prefixMatch | string | Matches if the request path starts with this prefix. |
| regexMatch | string | Matches if the request path fully matches this regular expression. |
| headers | list of HttpRouteRuleMatchHeader | Conditions on request headers. All must match. |
| queryParameters | list of QueryParameterMatch | Conditions on URL query parameters. All must match. |
QueryParameterMatch
Condition on an HTTP query parameter.
A route match uses it to select requests by URL query parameter.
| Property | Type | Description |
|---|---|---|
| queryParameter | string | Name of the URL query parameter to test. |
| exactMatch | string | Matches if the parameter value equals this string. |
| regexMatch | string | Matches if the parameter value fully matches this regular expression. |
| presentMatch | string | If set, matches if the parameter is present, whatever its value. |
HttpRouteRuleMatchHeader
Condition on an HTTP header.
A route match uses it to select requests by header.
| Property | Type | Description |
|---|---|---|
| header | string | Name of the request header to test. |
| invertMatch | bool | If true, the rule applies when the header condition does NOT hold. |
| exactMatch | string | Matches if the header value equals this string. |
| regexMatch | string | Matches if the header value fully matches this regular expression. |
| prefixMatch | string | Matches if the header value starts with this prefix. |
| presentMatch | bool | If true, matches if the header is present, whatever its value. |
| suffixMatch | string | Matches if the header value ends with this suffix. |
| rangeMatch | RangeMatch | Matches if the header value is an integer in this range. |
RangeMatch
Integer range for a header test.
A header condition matches a header value against this range.
| Property | Type | Description |
|---|---|---|
| start | int64 | Lower bound (inclusive): the smallest integer that matches. |
| end | int64 | Upper bound (exclusive): one more than the largest integer that matches. |