---
title: "Returns a list of MeshFaultInjection in the mesh."
method: GET
path: "/v1/mesh/control-planes/{cpId}/api/meshes/{mesh}/meshfaultinjections"
tags: ["MeshFaultInjection"]
---

# Returns a list of MeshFaultInjection in the mesh.

`GET /v1/mesh/control-planes/{cpId}/api/meshes/{mesh}/meshfaultinjections`

## Path parameters

- `mesh` string, required

## Query parameters

- `offset` integer
- `size` integer
- `filter` object
  - `key` string
  - `value` string

## Response `200`

List

- object
  - `items` MeshFaultInjectionItem[]
    - `type` 'MeshFaultInjection', required — the type of the resource
    - `mesh` string — Mesh is the name of the Kuma mesh this resource belongs to. It may be omitted for cluster-scoped resources.
    - `kri` string — A unique identifier for this resource instance used by internal tooling and integrations. Typically derived from resource attributes and may be used for cross-references or indexing
    - `name` string, required — Name of the Kuma resource
    - `labels` object — The labels to help identity resources
    - `spec` object, required — Spec is the specification of the Kuma MeshFaultInjection resource.
      - `from` object[] — From list makes a match between clients and corresponding configurations
        - `default` object — Default is a configuration specific to the group of destinations referenced in 'targetRef'
          - `http` object[] — Http allows to define list of Http faults between dataplanes.
            - `abort` object — Abort defines a configuration of not delivering requests to destination service and replacing the responses from destination dataplane by predefined status code
              - …
            - `delay` object — Delay defines configuration of delaying a response from a destination
              - …
            - `responseBandwidth` object — ResponseBandwidth defines a configuration to limit the speed of responding to the requests
              - …
        - `targetRef` object, required — TargetRef is a reference to the resource that represents a group of destinations.
          - `kind` 'Mesh' | 'MeshSubset' | 'MeshGateway' | 'MeshService' | 'MeshExternalService' | 'MeshMultiZoneService' | 'MeshServiceSubset' | 'MeshHTTPRoute' | 'Dataplane', required — Kind of the referenced resource
          - `labels` object — Labels are used to select group of MeshServices that match labels. Either Labels or Name and Namespace can be used.
          - `mesh` string — Mesh is reserved for future use to identify cross mesh resources.
          - `name` string — Name of the referenced resource. Can only be used with kinds: `MeshService`, `MeshServiceSubset` and `MeshGatewayRoute`
          - `namespace` string — Namespace specifies the namespace of target resource. If empty only resources in policy namespace will be targeted.
          - `proxyTypes` string[] — ProxyTypes specifies the data plane types that are subject to the policy. When not specified, all data plane types are targeted by the policy.
          - `sectionName` string — SectionName is used to target specific section of resource. For example, you can target port from MeshService.ports[] by its name. Only traffic to this port will be affected.
          - `tags` object — Tags used to select a subset of proxies by tags. Can only be used with kinds `MeshSubset` and `MeshServiceSubset`
      - `rules` object[] — Rules defines inbound fault injection configuration
        - `default` object, required — Default defines fault configuration
          - `http` object[] — Http allows to define list of Http faults between dataplanes.
            - `abort` object — Abort defines a configuration of not delivering requests to destination service and replacing the responses from destination dataplane by predefined status code
              - …
            - `delay` object — Delay defines configuration of delaying a response from a destination
              - …
            - `responseBandwidth` object — ResponseBandwidth defines a configuration to limit the speed of responding to the requests
              - …
        - `matches` object[] — Matches defines list of matches for which fault injection will be applied
          - `spiffeID` object — SpiffeID defines a matcher configuration for SpiffeID matching
            - `type` 'Exact' | 'Prefix', required — Type defines how to match incoming traffic by SpiffeID. `Exact` or `Prefix` are allowed.
            - `value` string, required — Value is SpiffeId of a client that needs to match for the configuration to be applied
      - `targetRef` object — TargetRef is a reference to the resource the policy takes an effect on. The resource could be either a real store object or virtual resource defined inplace.
        - `kind` 'Mesh' | 'MeshSubset' | 'MeshGateway' | 'MeshService' | 'MeshExternalService' | 'MeshMultiZoneService' | 'MeshServiceSubset' | 'MeshHTTPRoute' | 'Dataplane', required — Kind of the referenced resource
        - `labels` object — Labels are used to select group of MeshServices that match labels. Either Labels or Name and Namespace can be used.
        - `mesh` string — Mesh is reserved for future use to identify cross mesh resources.
        - `name` string — Name of the referenced resource. Can only be used with kinds: `MeshService`, `MeshServiceSubset` and `MeshGatewayRoute`
        - `namespace` string — Namespace specifies the namespace of target resource. If empty only resources in policy namespace will be targeted.
        - `proxyTypes` string[] — ProxyTypes specifies the data plane types that are subject to the policy. When not specified, all data plane types are targeted by the policy.
        - `sectionName` string — SectionName is used to target specific section of resource. For example, you can target port from MeshService.ports[] by its name. Only traffic to this port will be affected.
        - `tags` object — Tags used to select a subset of proxies by tags. Can only be used with kinds `MeshSubset` and `MeshServiceSubset`
      - `to` object[] — To list makes a match between clients and corresponding configurations
        - `default` object — Default is a configuration specific to the group of destinations referenced in 'targetRef'
          - `http` object[] — Http allows to define list of Http faults between dataplanes.
            - `abort` object — Abort defines a configuration of not delivering requests to destination service and replacing the responses from destination dataplane by predefined status code
              - …
            - `delay` object — Delay defines configuration of delaying a response from a destination
              - …
            - `responseBandwidth` object — ResponseBandwidth defines a configuration to limit the speed of responding to the requests
              - …
        - `targetRef` object, required — TargetRef is a reference to the resource that represents a group of destinations.
          - `kind` 'Mesh' | 'MeshSubset' | 'MeshGateway' | 'MeshService' | 'MeshExternalService' | 'MeshMultiZoneService' | 'MeshServiceSubset' | 'MeshHTTPRoute' | 'Dataplane', required — Kind of the referenced resource
          - `labels` object — Labels are used to select group of MeshServices that match labels. Either Labels or Name and Namespace can be used.
          - `mesh` string — Mesh is reserved for future use to identify cross mesh resources.
          - `name` string — Name of the referenced resource. Can only be used with kinds: `MeshService`, `MeshServiceSubset` and `MeshGatewayRoute`
          - `namespace` string — Namespace specifies the namespace of target resource. If empty only resources in policy namespace will be targeted.
          - `proxyTypes` string[] — ProxyTypes specifies the data plane types that are subject to the policy. When not specified, all data plane types are targeted by the policy.
          - `sectionName` string — SectionName is used to target specific section of resource. For example, you can target port from MeshService.ports[] by its name. Only traffic to this port will be affected.
          - `tags` object — Tags used to select a subset of proxies by tags. Can only be used with kinds `MeshSubset` and `MeshServiceSubset`
    - `creationTime` string, date-time — Time at which the resource was created
    - `modificationTime` string, date-time — Time at which the resource was updated
  - `total` number — The total number of entities
  - `next` string — URL to the next page

---

[API](https://skmtc.net/kong/apis/konnect-api-beta.md) · [All operations](https://skmtc.net/kong/apis/konnect-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kong/konnect-api-beta/revisions/73b05fbfd2ef/schema)