v28

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-263064641.4 MB
MeshAccessLog

Returns a list of MeshAccessLog in the mesh.

get/v1/mesh/control-planes/{cpId}/api/meshes/{mesh}/meshaccesslogs

Path parameters

meshstring required

name of the mesh

Query parameters

offsetinteger

offset in the list of entities

sizeinteger

the number of items per page

keystring
valuestring

filter by labels when multiple filters are present, they are ANDed

Response

List

totalnumber

The total number of entities

nextstring

URL to the next page

Example response

{
  "items": [
    {
      "kri": "kri_mal_default_zone-east_kuma-demo_mypolicy1_",
      "spec": {
        "from": [
          {
            "default": {
              "backends": [
                {
                  "file": {
                    "format": {
                      "json": [
                        {
                          "key": "start_time",
                          "value": "%START_TIME%"
                        },
                        {
                          "key": "bytes_received",
                          "value": "%BYTES_RECEIVED%"
                        }
                      ],
                      "plain": "[%START_TIME%] %KUMA_MESH% %UPSTREAM_HOST%"
                    },
                    "path": "/tmp/access.log"
                  },
                  "openTelemetry": {
                    "attributes": [
                      {
                        "key": "mesh",
                        "value": "%KUMA_MESH%"
                      }
                    ],
                    "body": {
                      "kvlistValue": {
                        "values": [
                          {
                            "key": "mesh",
                            "value": {
                              "stringValue": "%KUMA_MESH%"
                            }
                          }
                        ]
                      }
                    },
                    "endpoint": "otel-collector:4317"
                  },
                  "tcp": {
                    "address": "127.0.0.1:5000",
                    "format": {
                      "json": [
                        {
                          "key": "start_time",
                          "value": "%START_TIME%"
                        },
                        {
                          "key": "bytes_received",
                          "value": "%BYTES_RECEIVED%"
                        }
                      ],
                      "plain": "[%START_TIME%] %KUMA_MESH% %UPSTREAM_HOST%"
                    }
                  }
                }
              ]
            }
          }
        ],
        "rules": [
          {
            "default": {
              "backends": [
                {
                  "file": {
                    "format": {
                      "json": [
                        {
                          "key": "start_time",
                          "value": "%START_TIME%"
                        },
                        {
                          "key": "bytes_received",
                          "value": "%BYTES_RECEIVED%"
                        }
                      ],
                      "plain": "[%START_TIME%] %KUMA_MESH% %UPSTREAM_HOST%"
                    },
                    "path": "/tmp/access.log"
                  },
                  "openTelemetry": {
                    "attributes": [
                      {
                        "key": "mesh",
                        "value": "%KUMA_MESH%"
                      }
                    ],
                    "body": {
                      "kvlistValue": {
                        "values": [
                          {
                            "key": "mesh",
                            "value": {
                              "stringValue": "%KUMA_MESH%"
                            }
                          }
                        ]
                      }
                    },
                    "endpoint": "otel-collector:4317"
                  },
                  "tcp": {
                    "address": "127.0.0.1:5000",
                    "format": {
                      "json": [
                        {
                          "key": "start_time",
                          "value": "%START_TIME%"
                        },
                        {
                          "key": "bytes_received",
                          "value": "%BYTES_RECEIVED%"
                        }
                      ],
                      "plain": "[%START_TIME%] %KUMA_MESH% %UPSTREAM_HOST%"
                    }
                  }
                }
              ]
            }
          }
        ],
        "to": [
          {
            "default": {
              "backends": [
                {
                  "file": {
                    "format": {
                      "json": [
                        {
                          "key": "start_time",
                          "value": "%START_TIME%"
                        },
                        {
                          "key": "bytes_received",
                          "value": "%BYTES_RECEIVED%"
                        }
                      ],
                      "plain": "[%START_TIME%] %KUMA_MESH% %UPSTREAM_HOST%"
                    },
                    "path": "/tmp/access.log"
                  },
                  "openTelemetry": {
                    "attributes": [
                      {
                        "key": "mesh",
                        "value": "%KUMA_MESH%"
                      }
                    ],
                    "body": {
                      "kvlistValue": {
                        "values": [
                          {
                            "key": "mesh",
                            "value": {
                              "stringValue": "%KUMA_MESH%"
                            }
                          }
                        ]
                      }
                    },
                    "endpoint": "otel-collector:4317"
                  },
                  "tcp": {
                    "address": "127.0.0.1:5000",
                    "format": {
                      "json": [
                        {
                          "key": "start_time",
                          "value": "%START_TIME%"
                        },
                        {
                          "key": "bytes_received",
                          "value": "%BYTES_RECEIVED%"
                        }
                      ],
                      "plain": "[%START_TIME%] %KUMA_MESH% %UPSTREAM_HOST%"
                    }
                  }
                }
              ]
            }
          }
        ]
      },
      "creationTime": "0001-01-01T00:00:00Z",
      "modificationTime": "0001-01-01T00:00:00Z"
    }
  ]
}