Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Exoscale cluster API

Clusters are managed Kubernetes control planes.

Exoscale cluster API is one of 37 APIs that Exoscale publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include cluster. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and pricing.

This API exposes 16 operations across 13 paths, and defines 25 schemas. It is described by OpenAPI 3.0.0, at version 2.0.0.

Requests are made against a single base URL, https://api-{zone}.exoscale.com/v2.

16 operations 13 paths 25 schemas 1 DELETE6 GET2 POST7 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
2.0.0
Base URL
https://api-ch-gva-2.exoscale.com/v2
Terms of Service
Resource Areas
1

Paths & Operations 16

Across 13 paths, the API surfaces 16 operations — 1 DELETE, 6 GET, 2 POST, 7 PUT. Each is listed below with its method, path, parameters, and response codes.

cluster 16

Clusters are managed Kubernetes control planes.

POST
/sks-cluster-kubeconfig/{id}
Generate a new Kubeconfig file for a SKS cluster
generate-sks-cluster-kubeconfig 1 param body → 200
GET
/sks-cluster/{id}/authority/{authority}/cert
Get the certificate for a SKS cluster authority
get-sks-cluster-authority-cert 2 params → 200
GET
/sks-cluster-deprecated-resources/{id}
Resources that are scheduled to be removed in future kubernetes releases
list-sks-cluster-deprecated-resources 1 param → 200
PUT
/sks-cluster/{id}/upgrade-service-level
Upgrade a SKS cluster to pro
upgrade-sks-cluster-service-level 1 param → 200
PUT
/sks-cluster/{id}/rotate-csi-credentials
Rotate Exoscale CSI credentials
rotate-sks-csi-credentials 1 param → 200
POST
/sks-cluster
Create an SKS cluster
create-sks-cluster body → 200
GET
/sks-cluster
List SKS clusters
list-sks-clusters → 200
DELETE
/sks-cluster/{id}
Delete an SKS cluster
delete-sks-cluster 1 param → 200
GET
/sks-cluster/{id}
Retrieve SKS cluster details
get-sks-cluster 1 param → 200
PUT
/sks-cluster/{id}
Update an SKS cluster
update-sks-cluster 1 param body → 200
GET
/sks-cluster/{id}/inspection
Get the latest inspection result
get-sks-cluster-inspection 1 param → 200
PUT
/sks-cluster/{id}/rotate-ccm-credentials
Rotate Exoscale CCM credentials
rotate-sks-ccm-credentials 1 param → 200
PUT
/sks-cluster/{id}/rotate-karpenter-credentials
Rotate Exoscale Karpenter credentials
rotate-sks-karpenter-credentials 1 param → 200
PUT
/sks-cluster/{id}/rotate-operators-ca
Rotate operators certificate authority
rotate-sks-operators-ca 1 param → 200
GET
/sks-cluster-version
List available versions for SKS clusters
list-sks-cluster-versions 1 param → 200
PUT
/sks-cluster/{id}/upgrade
Upgrade an SKS cluster
upgrade-sks-cluster 1 param body → 200

Schemas 25

The contract defines 25 schemas that model the data the API accepts and returns. The most detailed are sks-nodepool (21 properties), sks-cluster (18 properties), sks-oidc (7 properties), sks-cluster-deprecated-resource (5 properties). Each schema is shown below with its type and property counts.

instance-type-ref
object
Instance type reference
1 property
security-group-ref
object
Security group reference
1 property
template-ref
object
Template reference
1 property
sks-nodepool-taints
object
sks-audit
object
Kubernetes Audit parameters
3 properties
networking
object
Cluster networking configuration.
4 properties
sks-audit-endpoint
string
operation
object
Operation
5 properties
sks-oidc
object
SKS Cluster OpenID config map
7 properties 2 required
deploy-target-ref
object
Deploy target reference
1 property
sks-audit-create
object
Kubernetes Audit parameters
3 properties 2 required
sks-nodepool-taint
object
Nodepool taint
2 properties 2 required
sks-audit-initial-backoff
string
sks-cluster-labels
object
sks-nodepool-labels
object
private-network-ref
object
Private network reference
1 property
instance-pool-ref
object
Target Instance Pool
1 property
sks-audit-update
object
Kubernetes Audit parameters
4 properties
kubelet-image-gc
object
Kubelet image GC options
3 properties
sks-nodepool
object
SKS Nodepool
21 properties
anti-affinity-group-ref
object
Anti-affinity group reference
1 property
sks-kubeconfig-request
object
Kubeconfig request for a SKS cluster
3 properties 2 required
sks-audit-bearer-token
string
sks-cluster-deprecated-resource
object
5 properties
sks-cluster
object
SKS Cluster
18 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

exoscale-cluster-api-openapi.yml Raw ↑

Other APIs Exoscale publishes across the network.

Exoscale ai-api-key API
Exoscale anti-affinity-group API
Exoscale api-key API
Exoscale block-storage API
Exoscale ccm API
Exoscale compute API
Exoscale crypto API
Exoscale dbaas API
Exoscale deploy-target API
Exoscale deployment API
Exoscale domain API
Exoscale elastic-ip API