Grpc Route
GrpcRoute
Defines the high-level intent for routing gRPC traffic.
The engine turns it into service mesh or load balancer configuration. It supports method-level routing, retry policies, and timeouts.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be GrpcRoute. |
| 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 gRPC route configuration. See Spec. |
Target
Resolved backend target of the route.
NOT YET IMPLEMENTED. The engine ignores this message and never sets it.
| Property | Type | Description |
|---|---|---|
| kind | string | Target resource kind. |
| name | string | Name of the resolved backend target manifest. |
Spec
User-defined gRPC routing rules.
The engine turns the rules into mesh gRPC route rules 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 GrpcRouteRule | Ordered list of match/forward rules. See GrpcRouteRule. Each rule becomes a mesh gRPC route rule bound to a hostname from the manifest name. A rule can set service/method matching, retries, timeouts, and fault injection. |
GrpcRouteRule
gRPC routing rule.
Pairs match conditions with an action.
| Property | Type | Description |
|---|---|---|
| matches | list of GrpcRouteRuleMatch | 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. |
GrpcRouteRuleMatch
Match criteria for a gRPC request.
Selects requests by metadata or by service and method.
| Property | Type | Description |
|---|---|---|
| headers | list of GrpcRouteRuleMatchHeader | Conditions on gRPC metadata. All must match. |
| method | MethodMatch | Restricts the rule to a gRPC service and method. |
GrpcRouteRuleMatchHeader
Condition on gRPC metadata.
Selects requests by custom metadata, the gRPC equivalent of HTTP headers.
| Property | Type | Description |
|---|---|---|
| key | string | Name of the metadata entry to test. |
| value | string | Expected value of the entry. type sets whether it is an exact value or a regular expression. |
| type | string | How to compare value: EXACT for a literal match or REGULAR_EXPRESSION for a regex match. TYPE_UNSPECIFIED means EXACT. |
MethodMatch
Match by gRPC service or method.
The main routing condition of a gRPC route, in place of a URL path match.
| Property | Type | Description |
|---|---|---|
| grpcService | string | Fully qualified gRPC service name, for example package.Service. |
| grpcMethod | string | Method of the service. |
| caseSensitive | bool | If true, service and method names are case-sensitive. |