Policies · Mesh* policies
MeshFaultInjection
HTTP delays, aborts and bandwidth limits on a proxy's inbound traffic.
Behaviour per target
Output: MeshFaultInjection
Copied unchanged. from[] is reported as deprecated in favour of rules[] and is not
converted: rules[].matches[] selects clients by SPIFFE ID or SNI. Omitting matches[]
applies the fault to all clients. from[].targetRef.kind: MeshService is reported as
deprecated since 2.7. A Subset-scenario policy keeps from[] MeshSubset with the
kuma.io/service tag (the 2.7+ form) instead of rewriting it to MeshService.
Output: MeshFaultInjection
When every from[] entry targets kind: Mesh, from[] is rewritten to rules[]
without matches[], which keeps the "every client" scope. Any narrower entry blocks the
rewrite: the policy is reported as an error and written to _manual/, not to the apply
tree.
to[] accepts only kind: Mesh, and only when spec.targetRef is kind: Mesh; other
combinations are reported as an error and written to _manual/. Labels-only refs and
control-plane label removal apply.
Timeline
| Version | Change |
|---|---|
| 2.7 | from[].targetRef.kind: MeshService deprecated; use MeshSubset with the kuma.io/service tag. |
| 2.13 | rules[] API added. |
| 2.14 | from[] deprecated. |
| 3.0 | from removed. to[] accepts kind: Mesh only. |
Related topics
- Policy targeting — Which targetRef kinds each policy accepts at each position on 2.14 and 3.0, labels-only selection, policy roles, and control-plane-owned labels.