Skip to main content
Reference material for Managed Kubernetes.

Provider kinds

The {provider} path segment in every endpoint below is one of:
Provider kindServiceLocation field
doksDigitalOcean Kubernetesregion
uksUpCloud Managed Kuberneteszone
gkeGoogle Kubernetes Enginelocation (zone or region)
ovh_mksOVHcloud Managed Kubernetesregion
aksAzure Kubernetes Servicelocation
eksAmazon EKSregion
The CLI accepts these values via --provider (ovh-mks and mks are accepted as aliases for ovh_mks).

API Reference

All endpoints are bearer-token authenticated under /org/clusters/managed/{provider}.
EndpointMethodDescription
/org/clusters/managed/{provider}/optionsGETLive regions, versions, sizes, plans, and capabilities for a credential_id
/org/clusters/managed/{provider}/discoverGETDiscover existing clusters at the provider for a credential_id
/org/clusters/managed/{provider}/preflightPOSTRun provider preflight checks without creating
/org/clusters/managed/{provider}/importPOSTAdopt a discovered cluster into Ankra
/org/clusters/managed/{provider}POSTCreate a managed cluster
/org/clusters/managed/{provider}/{cluster_id}DELETEDeprovision a managed cluster (?force=true to bypass idle checks)
/org/clusters/managed/{provider}/{cluster_id}/node-poolsGETList node pools
/org/clusters/managed/{provider}/{cluster_id}/node-poolsPOSTAdd a node pool
/org/clusters/managed/{provider}/{cluster_id}/node-pools/{name}/scalePOSTScale a node pool to a fixed count
/org/clusters/managed/{provider}/{cluster_id}/node-pools/{name}PATCHUpdate a node pool (count and/or autoscaling bounds)
/org/clusters/managed/{provider}/{cluster_id}/node-pools/{name}DELETEDelete a node pool
/org/clusters/managed/{provider}/{cluster_id}/upgradesGETList available Kubernetes upgrade targets
/org/clusters/managed/{provider}/{cluster_id}/upgradePOSTUpgrade the Kubernetes version
The ankra cluster managed CLI covers create, delete, node-pool add|scale|delete, and upgrade. Live options, discovery, import, preflight, and node-pool autoscaling bounds (PATCH) are portal/API only.

Provider-specific option blocks

ProviderBlockFields
DOKStop levelha - highly available control plane
UKStop levelcluster_plan (development / production); GPU pools take gpu_plan.storage_size
GKEgkerelease_channel (RAPID, REGULAR, STABLE), mode (standard or autopilot)
OVH MKSovh_mksplan (free, standard), private_network_id, anti_affinity, monthly_billed, update_policy
AKSaksresource_group, network_plugin (azure, kubenet), private_cluster, sku_tier (Free, Standard, Premium)
EKSekssubnet_ids, security_group_ids, enable_control_plane_logging