Create an SKS cluster

POST /sks-cluster
application/json

Body Required

  • description string

    Cluster description

    Maximum length is 255.

  • labels labels

    Resource labels

    Hide labels attribute Show labels attribute
  • 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 sks-oidc

    Cluster OpenID configmap

    Hide oidc attributes Show oidc attributes
    • 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
  • 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 operation
    • 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

      Hide reference attributes Show reference attributes
      • 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":{},"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":{}},"name":"string","level":"starter","addons":["exoscale-cloud-controller"],"version":"string"}'
Request example 
{
  "description": "string",
  "labels": {},
  "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": {}
  },
  "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"
}