Skip to content

RouteRules unsupported fields update #1268

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Oct 9, 2025
Merged

RouteRules unsupported fields update #1268

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1865f04
RouteRules unsupported fields update
tataruty Oct 8, 2025
49bd484
Adding conditions description for UnsupportedField
tataruty Oct 9, 2025
9a61d91
Fix conditions
tataruty Oct 9, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 17 additions & 1 deletion content/ngf/overview/gateway-api-compatibility.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,10 @@ Gateway API features has three [support levels](https://gateway-api.sigs.k8s.io/
- _Not supported_. The resource or field is not yet supported. It will become partially or fully supported in future
releases.

{{< call-out "note" >}} It's possible that NGINX Gateway Fabric will never support some resources or fields of the Gateway API. They will be documented on a case by case basis. {{< /call-out >}}
{{< call-out "note" >}} It's possible that NGINX Gateway Fabric will never support some resources or fields of the Gateway API. They will be documented on a case by case basis.

Please note that while we make every effort to reflect the support status of experimental fields in our code and documentation, there may be instances where this is not explicitly
indicated. Support for such fields is provided on a best-effort basis.{{< /call-out >}}


## Resources
Expand Down Expand Up @@ -116,6 +119,7 @@ See the [controller]({{< ref "/ngf/reference/cli-help.md#controller">}}) command
- `Accepted/False/UnsupportedValue`: Custom reason for when a value of a field in a Gateway is invalid or not supported.
- `Programmed/True/Programmed`
- `Programmed/False/Invalid`
- `Accepted/True/UnsupportedField`: Custom reason for when the Gateway is accepted but contains an unsupported field
- `listeners`
- `name`: Supported.
- `supportedKinds`: Supported.
Expand Down Expand Up @@ -165,6 +169,10 @@ See the [controller]({{< ref "/ngf/reference/cli-help.md#controller">}}) command
- `requestMirror`: Supported. Multiple mirrors can be specified. Percent and fraction-based mirroring are supported.
- `extensionRef`: Supported for SnippetsFilters.
- `backendRefs`: Partially supported. Backend ref `filters` are not supported.
- `name`: Not supported.
- `timeouts`: Not supported.
- `retry`: Not supported.
- `sessionPersistence`: Not supported.
- `status`
- `parents`
- `parentRef`: Supported.
Expand All @@ -186,6 +194,9 @@ See the [controller]({{< ref "/ngf/reference/cli-help.md#controller">}}) command
- `ResolvedRefs/False/InvalidIPFamily`: Custom reason for when one of the HTTPRoute rules has a backendRef that has an invalid IPFamily.
- `ResolvedRefs/False/UnsupportedProtocol`
- `PartiallyInvalid/True/UnsupportedValue`
- `Accepted/True/UnsupportedField`: Custom reason for when the HTTPRouteRule is accepted but contains an unsupported field

{{< call-out "note" >}} If `name`, `timeouts`, `retry` or `sessionPersistence` are defined for a HTTPRoute rule, they will be ignored and rule still will be created. {{< /call-out >}}

### GRPCRoute

Expand All @@ -211,6 +222,8 @@ See the [controller]({{< ref "/ngf/reference/cli-help.md#controller">}}) command
- `requestMirror`: Supported. Multiple mirrors can be specified.
- `extensionRef`: Supported for SnippetsFilters.
- `backendRefs`: Partially supported. Backend ref `filters` are not supported.
- `name`: Not supported.
- `sessionPersistence`: Not supported.
- `status`
- `parents`
- `parentRef`: Supported.
Expand All @@ -229,6 +242,9 @@ See the [controller]({{< ref "/ngf/reference/cli-help.md#controller">}}) command
- `ResolvedRefs/False/BackendNotFound`
- `ResolvedRefs/False/UnsupportedValue`: Custom reason for when one of the GRPCRoute rules has a backendRef with an unsupported value.
- `PartiallyInvalid/True/UnsupportedValue`
- `Accepted/True/UnsupportedField`: Custom reason for when the GRPCRouteRule is accepted but contains an unsupported field

{{< call-out "note" >}} If `name` or `sessionPersistence` are defined for a GRPCRoute rule, they will be ignored and rule still will be created. {{< /call-out >}}

### ReferenceGrant

Expand Down
Loading