---
title: "Creates or Updates MeshMultiZoneService entity"
method: PUT
path: "/v1/mesh/control-planes/{cpId}/api/meshes/{mesh}/meshmultizoneservices/{name}"
tags: ["MeshMultiZoneService"]
---

# Creates or Updates MeshMultiZoneService entity

`PUT /v1/mesh/control-planes/{cpId}/api/meshes/{mesh}/meshmultizoneservices/{name}`

## Path parameters

- `mesh` string, required
- `name` string, required

## Request body

- MeshMultiZoneServiceItem — MeshMultiZoneService provides global load balancing and service discovery across multiple zones in a multi-zone mesh deployment. It aggregates MeshServices from different zones by label selectors, creating a unified service endpoint with automatic VIP assignment and hostname generation for cross-zone communication and failover. MeshMultizoneServices are only created on global
  - `type` 'MeshMultiZoneService', 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 MeshMultiZoneService resource.
    - `ports` object[], required — Ports is a list of ports from selected MeshServices
      - `appProtocol` string — Protocol identifies a protocol supported by a service.
      - `name` string
      - `port` integer, required
    - `selector` object, required — Selector is a way to select multiple MeshServices
      - `meshService` object, required — MeshService selects MeshServices
        - `matchLabels` object
  - `creationTime` string, date-time — Time at which the resource was created
  - `modificationTime` string, date-time — Time at which the resource was updated
  - `status` object — Status is the current status of the Kuma MeshMultiZoneService resource.
    - `addresses` object[] — Addresses is a list of addresses generated by HostnameGenerator
      - `hostname` string
      - `hostnameGeneratorRef` object
        - `coreName` string, required
      - `origin` string
    - `conditions` object[] — Conditions is an array of current conditions
      - `message` string, required — message is a human readable message indicating details about the transition. This may be an empty string.
      - `reason` string, required — reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
      - `status` 'True' | 'False' | 'Unknown', required — status of the condition, one of True, False, Unknown.
      - `type` string, required — type of condition in CamelCase or in foo.example.com/CamelCase.
    - `hostnameGenerators` object[] — Status of hostnames generator applied on this resource
      - `conditions` object[] — Conditions is an array of hostname generator conditions.
        - `message` string, required — message is a human readable message indicating details about the transition. This may be an empty string.
        - `reason` string, required — reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
        - `status` 'True' | 'False' | 'Unknown', required — status of the condition, one of True, False, Unknown.
        - `type` string, required — type of condition in CamelCase or in foo.example.com/CamelCase.
      - `hostnameGeneratorRef` object, required
        - `coreName` string, required
    - `meshServices` object[] — MeshServices is a list of matched MeshServices
      - `mesh` string, required
      - `name` string, required — Name is a core name of MeshService
      - `namespace` string, required
      - `zone` string, required
    - `vips` object[] — VIPs is a list of assigned Kuma VIPs.
      - `ip` string

## Response `200`

Successful response

- object
  - `warnings` string[] — 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.

## Other responses

- `201` — Successful response

---

[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/versions/73b05fbfd2ef/schema)