Retrieve SKS Nodepool details

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://openapi-v2.exoscale.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Exoscale APIv2 MCP server": {
    "url": "https://openapi-v2.exoscale.com/mcp"
  }
}
Close
GET /sks-cluster/{id}/nodepool/{sks-nodepool-id}

Path parameters

  • id string(uuid) Required
  • sks-nodepool-id string(uuid) Required

Responses

  • 200 application/json

    200

    Hide response attributes Show response attributes object
    • anti-affinity-groups array[object]

      Nodepool Anti-affinity Groups

      Not more than 8 elements.

      Hide anti-affinity-groups attribute Show anti-affinity-groups attribute object

      Anti-affinity group reference

      • id string(uuid)

        Anti-affinity group ID

    • description string

      Nodepool description

      Maximum length is 255.

    • public-ip-assignment string

      Nodepool public IP assignment of the Instances:

      • IPv4 (inet4) addressing only;
      • IPv4 and IPv6 (dual) addressing.

      Values are inet4 or dual.

    • labels object

      Nodepool labels

      Hide labels attribute Show labels attribute object
      • * string Additional properties
    • taints object

      Nodepool taints

      Hide taints attribute Show taints attribute object
      • * object Additional properties

        Nodepool taint

        Hide * attributes Show * attributes object
        • value string Required

          Nodepool taint value

          Minimum length is 1, maximum length is 255.

        • effect string Required

          Nodepool taint effect

          Values are NoExecute, NoSchedule, or PreferNoSchedule.

    • security-groups array[object]

      Nodepool Security Groups

      Not more than 16 elements.

      Hide security-groups attribute Show security-groups attribute object

      Security group reference

      • id string(uuid)

        Security group ID

    • name string

      Nodepool name

      Minimum length is 1, maximum length is 255.

    • instance-type object

      Nodepool Instances type

      Hide instance-type attribute Show instance-type attribute object
      • id string(uuid)

        Instance type ID

    • private-networks array[object]

      Nodepool Private Networks

      Not more than 16 elements.

      Hide private-networks attribute Show private-networks attribute object

      Private network reference

      • id string(uuid)

        Private network ID

    • template object

      Nodepool Instance template

      Hide template attribute Show template attribute object
      • id string(uuid)

        Template ID

    • state string

      Nodepool state

      Values are renewing-token, creating, deleting, running, scaling, updating, or error.

    • size integer(int64)

      Number of instances

      Minimum value is 0.

    • kubelet-image-gc object

      Kubelet image GC options

      Hide kubelet-image-gc attributes Show kubelet-image-gc attributes object
      • high-threshold integer(int64)

        Minimum value is 0.

      • low-threshold integer(int64)

        Minimum value is 0.

      • min-age string
    • instance-pool object

      Instance Pool managed by the Nodepool

      Hide instance-pool attribute Show instance-pool attribute object
      • id string(uuid)

        Instance Pool ID

    • instance-prefix string

      The instances created by the Nodepool will be prefixed with this value (default: pool)

      Minimum length is 1, maximum length is 30.

    • deploy-target object

      Instance Pool Deploy Target

      Hide deploy-target attribute Show deploy-target attribute object
      • id string(uuid)

        Deploy target ID

    • addons array[string]

      Nodepool addons

      Value is storage-lvm.

    • id string(uuid)

      Nodepool ID

    • disk-size integer(int64)

      Nodepool instances disk size in GiB

      Minimum value is 20, maximum value is 51200.

    • version string

      Nodepool version

    • nvidia-mig-profiles object

      Nvidia MIG Profiles

      Hide nvidia-mig-profiles attributes Show nvidia-mig-profiles attributes object
      • a30.24gb string

        Nvidia A30 MIG Profile

        Values are 2g.12gb, 1g.6gb+me, 1g.6gb, 2g.12gb+me, or 4g.24gb.

      • rtxpro6000.96gb string

        Nvidia RTXPRO6000 MIG Profile

        Values are 1g.24gb-me, 1g.24gb, 2g.48gb-me, 2g.48gb, 4g.96gb+gfx, 1g.24gb+me, 2g.48gb+me.all, 1g.24gb+gfx, 1g.24gb+me.all, 4g.96gb, or 2g.48gb+gfx.

    • created-at string(date-time)

      Nodepool creation date
GET /sks-cluster/{id}/nodepool/{sks-nodepool-id} 
curl \
 --request GET 'https://api-ch-gva-2.exoscale.com/v2/sks-cluster/{id}/nodepool/{sks-nodepool-id}'
Response examples (200) 
{
  "anti-affinity-groups": [
    {
      "id": "string"
    }
  ],
  "description": "string",
  "public-ip-assignment": "inet4",
  "labels": {
    "additionalProperty1": "string",
    "additionalProperty2": "string"
  },
  "taints": {
    "additionalProperty1": {
      "value": "string",
      "effect": "NoExecute"
    },
    "additionalProperty2": {
      "value": "string",
      "effect": "NoExecute"
    }
  },
  "security-groups": [
    {
      "id": "string"
    }
  ],
  "name": "string",
  "instance-type": {
    "id": "string"
  },
  "private-networks": [
    {
      "id": "string"
    }
  ],
  "template": {
    "id": "string"
  },
  "state": "renewing-token",
  "size": 42,
  "kubelet-image-gc": {
    "high-threshold": 42,
    "low-threshold": 42,
    "min-age": "string"
  },
  "instance-pool": {
    "id": "string"
  },
  "instance-prefix": "string",
  "deploy-target": {
    "id": "string"
  },
  "addons": [
    "storage-lvm"
  ],
  "id": "string",
  "disk-size": 42,
  "version": "string",
  "nvidia-mig-profiles": {
    "a30.24gb": "2g.12gb",
    "rtxpro6000.96gb": "1g.24gb-me"
  },
  "created-at": "2026-05-04T09:42:00Z"
}