Update Cluster Region Locations

PATCH

/clusters/{cluster_id}/region-locations

curl --request PATCH \
  --url https://api.mengi.cloud/clusters/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/region-locations \
  --header 'Content-Type: application/json' \
  --data '{ "region_locations": [ "example" ] }'

Update multi-region locations for a Hetzner production cluster.

Changes which eu-central datacenters worker nodes are distributed across. This triggers a Pulumi update that may recreate servers in new locations.

Parameters

Path Parameters

cluster_id

required

Cluster Id

string format: uuid

Request Body ^required

Media type application/json

RegionLocationsUpdate

Schema for updating multi-region locations on a Hetzner production cluster.

object

region_locations

required

Region Locations

Array<string>

>= 1 items <= 3 items

Example ^generated

{
  "region_locations": [
    "example"
  ]
}

Responses

200

Successful Response

Media type application/json

ClusterResponse

object

id

required

Id

string format: uuid

name

required

Name

string

provider

required

Provider

string

region

required

Region

string

tier

required

ClusterTier

string

Allowed values: shared testing production

status

required

ClusterStatus

string

Allowed values: pending provisioning importing running upgrading error deleting

kubernetes_version

Any of:

string

string

null

null

server_type

Any of:

string

string

null

null

argocd_url

Any of:

string

string

null

null

git_repo_url

Any of:

string

string

null

null

error_message

Any of:

string

string

null

null

status_message

Any of:

string

string

null

null

created_at

required

Created At

string format: date-time

updated_at

required

Updated At

string format: date-time

provisioning_started_at

Any of:

string

string format: date-time

null

null

provisioning_completed_at

Any of:

string

string format: date-time

null

null

autoscaling_enabled

Autoscaling Enabled

boolean

min_nodes

Any of:

integer

integer

null

null

max_nodes

Any of:

integer

integer

null

null

target_kubernetes_version

Any of:

string

string

null

null

upgrade_available

Upgrade Available

boolean

upgrade_available_version

Any of:

string

string

null

null

scheduled_upgrade_date

Any of:

string

string format: date-time

null

null

scheduled_upgrade_id

Any of:

string

string format: uuid

null

null

component_bundle_version

Component Bundle Version

string

default: latest

multi_region

Multi Region

boolean

region_locations

Any of:

Array<string>

Array<string>

null

null

is_byoc

Is Byoc

boolean

cloud_credential_id

Any of:

string

string format: uuid

null

null

is_imported

Is Imported

boolean

is_autopilot

Is Autopilot

boolean

display_order

Any of:

integer

integer

null

null

Example

{
  "tier": "shared",
  "status": "pending",
  "autoscaling_enabled": false,
  "upgrade_available": false,
  "component_bundle_version": "latest",
  "multi_region": false,
  "is_byoc": false,
  "is_imported": false,
  "is_autopilot": false
}

422

Validation Error

Media type application/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example ^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}