MeshAccessLog

Creates or Updates MeshAccessLog entity

Changed on
put/v1/mesh/control-planes/{cpId}/api/meshes/{mesh}/meshaccesslogs/{name}

Request

  • Base URL: https://global.api.konghq.com
  • URL: https://global.api.konghq.com/v1/mesh/control-planes/{cpId}/api/meshes/{mesh}/meshaccesslogs/{name}
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer

Path parameters

meshstring required

name of the mesh

namestring required

name of the MeshAccessLog

Request body

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 request

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

Response

Successful response

warningsstring[]

warnings is a list of warning messages to return to the requesting Kuma API clients. Warning messages describe a problem the client making the API request should correct or be aware of.

Changes

  • 658ffb748f95Revision changes
    • breaking

      added the pattern ^[a-z]([a-z0-9]|[._][a-z0-9])*$ to the request property /////////

    • breaking

      added the pattern ^[a-z]([a-z0-9]|[._][a-z0-9])*$ to the request property /////////

    • breaking

      added the pattern ^[a-z]([a-z0-9]|[._][a-z0-9])*$ to the request property /////////

    • info

      added the new optional request property ///////

    • info

      added the new optional request property ///////

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///////

    • info

      the request property /////// became optional

    • info

      the request property /////// became optional

    • info

      the request property /////// became optional

    • info

      the request property default value was added

    • info

      the request property default value was added

    • info

      the request property default value was added

    • info

      the /////// request property's minLength was decreased from 1 to 0

    • info

      the /////// request property's minLength was decreased from 1 to 0

    • info

      the /////// request property's minLength was decreased from 1 to 0

  • b2800570b3e2Revision changes
    • info

      endpoint added