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 attributes Show labels attributes object
  • cni string

    Cluster CNI

    Values are calico or cilium.

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

  • oidc object

    Cluster OpenID configmap

    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.

    • JWT claim to use as the user name

      Minimum length is 1, maximum length is 255.

    • Prefix prepended to username claims

      Minimum length is 1, maximum length is 255.

    • JWT claim to use as the user's group

      Minimum length is 1, maximum length is 255.

    • Prefix prepended to group claims

      Minimum length is 1, maximum length is 255.

    • A key value map that describes a required claim in the ID Token

      Hide required-claim attributes Show required-claim attributes object
  • 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.

    • Related resource reference

      Hide reference attributes Show reference attributes object
      • id string(uuid)

        Reference ID

      • 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":{"key":"string","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":{"key":"string","additionalProperty1":"string","additionalProperty2":"string"}},"name":"string","level":"starter","addons":["exoscale-cloud-controller"],"version":"string"}'
Request examples
{
  "description": "string",
  "labels": {
    "key": "string",
    "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": {
      "key": "string",
      "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"
}