> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ankra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Managed Kubernetes Reference

> Provider kinds, API endpoints, and provider-specific option blocks for Ankra-managed cloud Kubernetes (DOKS, UKS, GKE, OVHcloud MKS, AKS, EKS).

Reference material for [Managed Kubernetes](/guides/managed-kubernetes).

***

## Provider kinds

The `{provider}` path segment in every endpoint below is one of:

| Provider kind | Service                                                 | Location field            |
| ------------- | ------------------------------------------------------- | ------------------------- |
| `doks`        | [DigitalOcean Kubernetes](/guides/doks-clusters)        | region                    |
| `uks`         | [UpCloud Managed Kubernetes](/guides/uks-clusters)      | zone                      |
| `gke`         | [Google Kubernetes Engine](/guides/gke-clusters)        | location (zone or region) |
| `ovh_mks`     | [OVHcloud Managed Kubernetes](/guides/ovh-mks-clusters) | region                    |
| `aks`         | [Azure Kubernetes Service](/guides/aks-clusters)        | location                  |
| `eks`         | [Amazon EKS](/guides/eks-clusters)                      | region                    |

<Note>
  The CLI accepts these values via `--provider` (`ovh-mks` and `mks` are accepted as aliases for `ovh_mks`).
</Note>

***

## API Reference

All endpoints are bearer-token authenticated under `/org/clusters/managed/{provider}`.

| Endpoint                                                                | Method | Description                                                                  |
| ----------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------- |
| `/org/clusters/managed/{provider}/options`                              | GET    | Live regions, versions, sizes, plans, and capabilities for a `credential_id` |
| `/org/clusters/managed/{provider}/discover`                             | GET    | Discover existing clusters at the provider for a `credential_id`             |
| `/org/clusters/managed/{provider}/preflight`                            | POST   | Run provider preflight checks without creating                               |
| `/org/clusters/managed/{provider}/import`                               | POST   | Adopt a discovered cluster into Ankra                                        |
| `/org/clusters/managed/{provider}`                                      | POST   | Create a managed cluster                                                     |
| `/org/clusters/managed/{provider}/{cluster_id}`                         | DELETE | Deprovision a managed cluster (`?force=true` to bypass idle checks)          |
| `/org/clusters/managed/{provider}/{cluster_id}/node-pools`              | GET    | List node pools                                                              |
| `/org/clusters/managed/{provider}/{cluster_id}/node-pools`              | POST   | Add a node pool                                                              |
| `/org/clusters/managed/{provider}/{cluster_id}/node-pools/{name}/scale` | POST   | Scale a node pool to a fixed count                                           |
| `/org/clusters/managed/{provider}/{cluster_id}/node-pools/{name}`       | PATCH  | Update a node pool (count and/or autoscaling bounds)                         |
| `/org/clusters/managed/{provider}/{cluster_id}/node-pools/{name}`       | DELETE | Delete a node pool                                                           |
| `/org/clusters/managed/{provider}/{cluster_id}/upgrades`                | GET    | List available Kubernetes upgrade targets                                    |
| `/org/clusters/managed/{provider}/{cluster_id}/upgrade`                 | POST   | Upgrade the Kubernetes version                                               |

<Note>
  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.
</Note>

***

## Provider-specific option blocks

| Provider | Block     | Fields                                                                                                                 |
| -------- | --------- | ---------------------------------------------------------------------------------------------------------------------- |
| DOKS     | top level | `ha` - highly available control plane                                                                                  |
| UKS      | top level | `cluster_plan` (`development` / `production`); GPU pools take `gpu_plan.storage_size`                                  |
| GKE      | `gke`     | `release_channel` (`RAPID`, `REGULAR`, `STABLE`), `mode` (`standard` or `autopilot`)                                   |
| OVH MKS  | `ovh_mks` | `plan` (`free`, `standard`), `private_network_id`, `anti_affinity`, `monthly_billed`, `update_policy`                  |
| AKS      | `aks`     | `resource_group`, `network_plugin` (`azure`, `kubenet`), `private_cluster`, `sku_tier` (`Free`, `Standard`, `Premium`) |
| EKS      | `eks`     | `subnet_ids`, `security_group_ids`, `enable_control_plane_logging`                                                     |