Service references
All operations require authentication.
List Kubernetes cluster regionsBeta
Returns the regions where a cluster can be created, with their availability zones and the plans offered there.
Path parameters
Project ID
Headers
Pagination cursor
Pagination size
Response
Availability zones in the region. Empty for a single-zone (mono-AZ) region.
Plans that can be selected when creating a cluster in this region
FREESTANDARDRegion identifier, for example EU-WEST-PAR
Example uses projectId = string
$ curl https:/[ { "availabilityZones": [ "string" ], "availablePlans": [ "FREE" ], "name": "string" }]
List Kubernetes cluster plansBeta
Returns the plans available for cluster creation in a region, with their control plane characteristics and limits. Requires a region.
Path parameters
Project ID
Query parameters
Region to list plans for. Plan availability varies by region. An unknown region returns 404.
Headers
Pagination cursor
Pagination size
Response
Control plane characteristics of the plan
Limits enforced by the plan
Plan name
FREESTANDARDAvailability of the plan for cluster creation
AVAILABLEUNAVAILABLEExample uses projectId = string
$ curl https:/[ { "controlPlane": { "etcd": { "dedicated": true, "storage": { "limit": 0, "unit": "COUNT" } } }, "limits": { "maxNodes": 0 }, "name": "FREE", "status": "AVAILABLE" }]
List Kubernetes node flavorsBeta
Returns the node flavors available for node pools in a region, with their category, resources and status. Requires a region.
Path parameters
Project ID
Query parameters
Region to list flavors for. Flavor availability varies by region. An unknown region returns 404.
Headers
Pagination cursor
Pagination size
Response
Category of the flavor
CPU_OPTIMIZEDDISCOVERYGENERAL_PURPOSEGPUIOPS_OPTIMIZEDMEMORY_OPTIMIZEDFlavor name, for example b3-8
Compute resources provided by the flavor
Availability of the flavor for node pool creation
AVAILABLEUNAVAILABLEExample uses projectId = string
$ curl https:/[ { "category": "CPU_OPTIMIZED", "name": "string", "resources": { "gpus": 0, "memoryGiB": 0, "vcpus": 0 }, "status": "AVAILABLE" }]
List Kubernetes versionsBeta
Returns the minor versions available for cluster creation, newest first, and the default version. Creation resolves a minor version to its latest patch.
Path parameters
Project ID
Response
Minor versions available for cluster creation, for example 1.34, newest first
Minor version applied when a creation request does not specify one, for example 1.34
Example uses projectId = string
$ curl https:/{ "availableVersions": [ { "status": "END_OF_SUPPORT", "version": "string" } ], "defaultVersion": "string"}