v28

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

MeshAccessLog

Returns MeshAccessLog entity

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

Path parameters

meshstring required

name of the mesh

namestring required

name of the MeshAccessLog

Response

Successful response

type'MeshAccessLog' required

the type of the resource

meshstring

Mesh is the name of the Kuma mesh this resource belongs to. It may be omitted for cluster-scoped resources.

kristring

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

namestring required

Name of the Kuma resource

labelsobject

The labels to help identity resources

creationTimestring date-time

Time at which the resource was created

modificationTimestring date-time

Time at which the resource was updated

Example response

{
  "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"
}