Create an SKS cluster

POST /sks-cluster

application/json

Body Required

description string | null

Cluster description

Maximum length is 255.
labels object

Resource labels
Hide labels attribute Show labels attribute object
- * string Additional properties
cni string

Cluster CNI

Values are calico or cilium.
auto-upgrade boolean

Enable auto upgrade of the control plane to the latest patch version available
oidc object

Cluster OpenID configmap

Additional properties are allowed.
Hide oidc attributes Show oidc attributes object
- client-id string Required
  
  OpenID client ID
  
  Minimum length is 1, maximum length is 255.
- issuer-url string Required
  
  OpenID provider URL
  
  Minimum length is 1, maximum length is 255.
- username-claim string
  
  JWT claim to use as the user name
  
  Minimum length is 1, maximum length is 255.
- username-prefix string
  
  Prefix prepended to username claims
  
  Minimum length is 1, maximum length is 255.
- groups-claim string
  
  JWT claim to use as the user's group
  
  Minimum length is 1, maximum length is 255.
- groups-prefix string
  
  Prefix prepended to group claims
  
  Minimum length is 1, maximum length is 255.
- required-claim object
  
  A key value map that describes a required claim in the ID Token
  Hide required-claim attribute Show required-claim attribute object
  
  * string Additional properties
name string Required

Cluster name

Minimum length is 1, maximum length is 255.
level string Required

Cluster service level

Values are starter or pro.
addons array[string]

Cluster addons

Values are exoscale-cloud-controller, exoscale-container-storage-interface, or metrics-server.
version string Required

Control plane Kubernetes version

Responses

200 application/json

200
Hide response attributes Show response attributes object
- id string(uuid)
  
  Operation ID
- reason string
  
  Operation failure reason
  
  Values are incorrect, unknown, unavailable, forbidden, busy, fault, partial, not-found, interrupted, unsupported, or conflict.
- reference object
  
  Related resource reference
  
  Additional properties are allowed.
  
  Hide reference attributes Show reference attributes object
  
  id string(uuid)
  
  Reference ID
  
  link string
  
  Link to the referenced resource
  
  command string
  
  Command name
- message string
  
  Operation message
- state string
  
  Operation status
  
  Values are failure, pending, success, or timeout.

POST /sks-cluster

curl \
 -X POST https://api-ch-gva-2.exoscale.com/v2/sks-cluster \
 -H "Content-Type: application/json" \
 -d '{"description":"string","labels":{"additionalProperty1":"string","additionalProperty2":"string"},"cni":"calico","auto-upgrade":true,"oidc":{"client-id":"string","issuer-url":"string","username-claim":"string","username-prefix":"string","groups-claim":"string","groups-prefix":"string","required-claim":{"additionalProperty1":"string","additionalProperty2":"string"}},"name":"string","level":"starter","addons":["exoscale-cloud-controller"],"version":"string"}'

Request examples

{
  "description": "string",
  "labels": {
    "additionalProperty1": "string",
    "additionalProperty2": "string"
  },
  "cni": "calico",
  "auto-upgrade": true,
  "oidc": {
    "client-id": "string",
    "issuer-url": "string",
    "username-claim": "string",
    "username-prefix": "string",
    "groups-claim": "string",
    "groups-prefix": "string",
    "required-claim": {
      "additionalProperty1": "string",
      "additionalProperty2": "string"
    }
  },
  "name": "string",
  "level": "starter",
  "addons": [
    "exoscale-cloud-controller"
  ],
  "version": "string"
}

Response examples (200)

{
  "id": "string",
  "reason": "incorrect",
  "reference": {
    "id": "string",
    "link": "string",
    "command": "string"
  },
  "message": "string",
  "state": "failure"
}