Split AGIC ingress resources when backend path prefixes must differ

Source facts

The AGIC backend-path-prefix annotation configures an HTTP setting with a backend path override. Microsoft warns that its single-rule example does not limit annotation scope: the annotation applies across the ingress resource and affects every specified path.

Rules that need different backend path prefixes must be defined in separate ingress resources, even when they use the same service. Microsoft Learn.

Applicability

Review the actual AGIC ingress, all of its path rules and the backend path expected by each application. Do not transfer this annotation behavior to another ingress controller without checking its own documentation.

DSE recommendation

DSE recommends comparing the complete ingress rule set before adding a prefix override to fix one application path. Separate paths that require different prefixes into the documented resource arrangement, with the application owner reviewing the resulting route map. Avoid accepting a one-path test as evidence that neighboring routes retain their intended backend paths.

Verification

Use an approved environment to request each affected path and inspect the path actually received at the backend. Include neighboring rules sharing the original ingress and confirm the intended separation after an authorized split. Check the rendered Application Gateway configuration as well as the application response. Preserve the ingress manifests and path-by-path outcomes so later consolidation does not silently reintroduce a shared override.

Official references

Microsoft Learn: Application Gateway Ingress Controller annotations. Source retrieved September 9, 2026.