Get a node | NVIDIA Kubernetes Engine

{
  "id": "a3f1c2d4-5e6b-7890-abcd-ef1234567890",
  "nodePoolID": "00000000-0000-0000-0000-000000000000",
  "nodeSetID": "00000000-0000-0000-0000-000000000000",
  "name": "tenant-a-prod-w-0001",
  "controlPlane": true,
  "conditions": {
    "pending": {
      "status": "False",
      "lastTransitionTime": "2024-03-10T08:00:05Z",
      "message": "Node has been claimed for provisioning"
    },
    "provisioningClaimed": {
      "status": "False",
      "lastTransitionTime": "2024-03-10T08:01:12Z",
      "message": "Provisioning has started"
    },
    "provisioning": {
      "status": "False",
      "lastTransitionTime": "2024-03-10T08:12:45Z",
      "message": "Provisioning completed successfully"
    },
    "readyToJoin": {
      "status": "False",
      "lastTransitionTime": "2024-03-10T08:14:30Z",
      "message": "Node has joined the cluster"
    },
    "joined": {
      "status": "True",
      "lastTransitionTime": "2024-03-10T08:15:02Z",
      "message": "Node successfully joined the cluster"
    },
    "provisioned": {
      "status": "True",
      "lastTransitionTime": "2024-03-10T08:16:00Z",
      "message": "Node is fully provisioned"
    },
    "deleting": {
      "status": "False",
      "lastTransitionTime": "2024-03-10T08:16:00Z",
      "message": ""
    },
    "kubernetesReady": {
      "status": "True",
      "lastTransitionTime": "2024-03-10T08:16:30Z",
      "message": "kubelet is posting ready status"
    },
    "kubernetesUnschedulable": {
      "status": "False",
      "lastTransitionTime": "2024-03-10T08:16:30Z",
      "message": ""
    },
    "nodeAgentReady": {
      "status": "True",
      "lastTransitionTime": "2024-03-10T08:17:00Z",
      "message": "Node agent is healthy"
    },
    "rebooting": {
      "status": "False",
      "lastTransitionTime": "2024-03-10T08:16:00Z",
      "message": ""
    },
    "markedForRecycling": {
      "status": "False",
      "lastTransitionTime": "2024-03-10T08:16:00Z",
      "message": ""
    },
    "markedForRepair": {
      "status": "False",
      "lastTransitionTime": "2024-03-10T08:16:00Z",
      "message": ""
    },
    "deleteRequested": {
      "status": "False",
      "lastTransitionTime": "2024-03-10T08:16:00Z",
      "message": ""
    },
    "controlPlaneRolloutRequired": {
      "status": "True",
      "lastTransitionTime": "2024-04-01T14:22:10Z",
      "message": "Node kubernetesVersion differs from desired configuration"
    }
  },
  "ip": "10.0.1.42",
  "nico": {
    "instanceID": "nico-inst-7f3a2b1c",
    "machineID": "nico-mach-4d8e9f0a",
    "instanceTypeID": "b2e4f6a8-1c3d-4e5f-9a0b-7c8d9e0f1a2b"
  },
  "launchLayer": {
    "instanceID": "ll-inst-9c2d4e6f",
    "machineID": "ll-mach-1a3b5c7d",
    "rackID": "rack-us-east-1a-07"
  },
  "controlPlaneRollout": {
    "pending": true,
    "actionable": true,
    "changes": [
      {
        "field": "kubernetesVersion",
        "from": "1.29.2",
        "to": "1.30.1"
      }
    ],
    "pinnedConfigurationID": "c1d2e3f4-a5b6-7890-cdef-012345678901",
    "desiredConfigurationID": "d4e5f6a7-b8c9-0123-def0-123456789abc"
  }
}

Returns one node. Control-plane nodes do not belong to a node pool, so their nodePoolID and nodeSetID are the nil UUID. nico is omitted when none of its fields are set.

Authentication

AuthorizationBearer

A JWT from an issuer the Operator has configured, carried as Authorization: Bearer <token>.

Path parameters

nodeIDstringRequiredformat: "uuid"

Node ID.

Response

The requested node

idstringformat: "uuid"

Node ID.

nodePoolIDstringformat: "uuid"

Owning node pool. The nil UUID for control-plane nodes.

nodeSetIDstringformat: "uuid"

Owning NodeSet. The nil UUID for control-plane nodes.

namestring

Node name.

controlPlaneboolean

Whether the node is a control-plane node.

conditionsobject

Lifecycle and health conditions.

ipstringOptionalformat: "ipv4"

Node IP address.

nicoobjectOptional

NICo instanceID, machineID and instanceTypeID. Omitted when none are set.

launchLayerobjectOptional

LaunchLayer instanceID, machineID and rackID. Omitted when none are set.

controlPlaneRolloutobjectOptional

Control-plane nodes only.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error