Kubernetes clusters

Get Kubernetes cluster by id

Returns a Managed Kubernetes cluster by cluster ID.

get/v1/kubernetes/{kubernetesId}

Request

Base URL
https://api.emma.ms/external
Auth
HTTP bearer

Path parameters

kubernetesIdinteger required

ID of the Kubernetes cluster

Query parameters

projectIdinteger

Unused, created for future API extention. Will be ignored if used.

Response

Successful operation

idinteger

ID of the Kubernetes cluster

createdAtstring

Date and time of the Kubernetes cluster creation

createdByIdinteger

ID of the user who created the Kubernetes cluster

createdByNamestring

Name of the user who created the Kubernetes cluster

modifiedAtstring

Date and time when the Kubernetes cluster was last edited

modifiedByNamestring

Name of the user who last edited the Kubernetes cluster

modifiedByIdinteger

ID of the user who last edited the Kubernetes cluster

namestring

Name of the Kubernetes cluster

versionstring

Version of the Kubernetes cluster

deploymentLocation'eu' | 'us'

Deployment region of the Kubernetes cluster

k8sConnectionType'direct_connect' | 'internet_connect'

Kubernetes connection type

domainNamestring nullable

Domain attached to the Kubernetes cluster

statusstring

Status of the Kubernetes cluster

Control plane status

Example response

{
  "id": 108182,
  "createdAt": "2026-03-13T08:22:47.05",
  "createdById": 2394,
  "createdByName": "Automation User",
  "modifiedAt": "2026-03-13T08:39:48.078",
  "modifiedByName": "Automation User",
  "modifiedById": 2394,
  "name": "default-k8s-managed-cluster-name",
  "version": "1.35",
  "deploymentLocation": "eu",
  "k8sConnectionType": "direct_connect",
  "domainName": null,
  "status": "ACTIVE",
  "controlPlaneStatus": "ACTIVE",
  "cost": {
    "unit": "MONTHS",
    "currency": "EUR",
    "price": 399.089284
  },
  "nodeGroups": [
    {
      "name": "Nodes",
      "nodes": [
        {
          "id": 108183,
          "createdAt": "2026-03-13T08:22:47.059",
          "name": "cffjqu-node",
          "status": "POWERED_ON",
          "instanceType": "on_demand",
          "nodeStatus": "ACTIVE",
          "provider": {
            "id": 79,
            "name": "AWS"
          },
          "location": {
            "id": 6,
            "name": "London",
            "country": "United Kingdom",
            "continent": "Europe",
            "region": "EMEA",
            "latitude": 51.50735,
            "longitude": -0.1277583
          },
          "dataCenter": {
            "id": "aws-eu-west-2",
            "name": "eu-west-2",
            "providerName": "AWS",
            "providerId": 79,
            "locationId": 6,
            "locationName": "London"
          },
          "os": {
            "id": 48,
            "family": "Linux",
            "type": "Ubuntu",
            "architecture": "x86-64",
            "version": "24.04"
          },
          "cloudNetworkType": "multi-cloud",
          "vCpuType": "hpc",
          "vCpu": 4,
          "ramGb": 16,
          "disks": [
            {
              "id": 108184,
              "name": "volume-9k61k2",
              "sizeGb": 128,
              "typeId": 2,
              "type": "ssd",
              "isBootable": true
            }
          ],
          "networks": [
            {
              "id": 108284,
              "ip": "10.112.17.28",
              "networkTypeId": 2,
              "networkType": "PRIVATE",
              "ipVersion": null
            },
            {
              "id": 108285,
              "ip": "18.132.41.135",
              "networkTypeId": 1,
              "networkType": "PUBLIC",
              "ipVersion": null
            }
          ],
          "cost": {
            "unit": "MONTHS",
            "currency": "EUR",
            "price": 399.089284
          },
          "securityGroup": {
            "id": 1764,
            "name": "sg-uat"
          },
          "accelerator": {
            "acceleratorTypeId": "53b7db26-4a1b-42f7-97a5-592edd685c5a",
            "acceleratorType": "T4",
            "accelerators": 1,
            "totalGpuMemoryGb": 16
          },
          "localDisks": [
            {
              "sizeTb": 0.125,
              "typeId": 1,
              "type": "ssd-plus"
            }
          ]
        }
      ],
      "status": "ACTIVE",
      "scalingPolicy": "SCALE_UP_ONLY"
    }
  ],
  "autoscalingConfigs": [
    {
      "groupName": "autoscalenodegroup-j6bj",
      "dataCenterId": "aws-eu-west-1",
      "minimumNodes": 1,
      "maximumNodes": 5,
      "targetNodes": 1,
      "minimumVCpus": null,
      "maximumVCpus": null,
      "targetVCpus": null,
      "nodeGroupPriceLimit": 50,
      "useOnDemandInstancesInsteadOfSpots": false,
      "spotPercent": 50,
      "spotMarkup": 5,
      "userLabels": [
        {
          "key": "workload",
          "value": "batch"
        }
      ],
      "configurationPriorities": [
        {
          "vCpuType": "shared",
          "vCpu": 2,
          "ramGb": 4,
          "volumeGb": 16,
          "volumeType": "ssd",
          "priority": "high"
        }
      ],
      "limitsNotice": null
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.