Sign in

v28

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

Creates or Updates MeshExternalService entity

put/v1/mesh/control-planes/{cpId}/api/meshes/{mesh}/meshexternalservices/{name}

Path parameters

meshstring required

name of the mesh

namestring required

name of the MeshExternalService

Request body

type'MeshExternalService' 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_extsvc_default_zone-east_kuma-system_myresource1_",
  "spec": {
    "endpoints": [
      {
        "address": "example.com"
      }
    ]
  },
  "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.