Import Cluster

POST

/clusters/import

curl --request POST \
  --url https://api.mengi.cloud/clusters/import \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "provider": "example", "region": "example", "cloud_credential_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "provider_cluster_id": "example", "kubeconfig": "example", "is_autopilot": false, "acknowledge_bundle_install": true, "override_preflight": false }'

Import an existing Kubernetes cluster into Mengi Cloud.

Runs preflight first and refuses the import if any error-severity conflicts are detected. Setting override_preflight=true lets an admin force the import; every override is logged with the user id.

Request Body ^required

Media type application/json

ClusterImport

Schema for importing an existing Kubernetes cluster.

object

name

required

Name

string

provider

required

Provider

string

region

required

Region

string

cloud_credential_id

Any of:

string

string format: uuid

null

null

provider_cluster_id

Any of:

string

string

null

null

kubeconfig

Any of:

string

string

null

null

is_autopilot

Is Autopilot

boolean

acknowledge_bundle_install

required

Acknowledge Bundle Install

boolean

override_preflight

Override Preflight

boolean

Responses

201

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