Skip to main content
GET
Get a reserved node
CLI equivalent: ornn machines show <node-id> --format json. To list every node in a reservation, use List reserved GPU nodes.

Authorizations

Authorization
string
header
required

Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.

Path Parameters

node_id
string<uuid>
required

A host node_id from the reservation's node list. Not a VM id.

Response

The node. The example shows a Bare Metal host with one installed key.

A reserved host node. Fields not listed under Node are SSH key delivery and reboot state.

node_id
string<uuid>
required
reservation_id
string<uuid> | null
required
controller_id
string<uuid> | null
required

The cluster currently holding this node, or null.

status
string
required

Node lifecycle or access mode, such as bare-metal; not a liveness signal.

health_readiness
object

Heartbeat-based launch preflight returned on reservation nodes. A stale heartbeat blocks launch. Missing heartbeat evidence returns ready true with heartbeat:unknown in advisory_reasons; this is not proof of host reachability, GPU health, or workload readiness. Treat an absent readiness object as unknown, not as ready. The reservation-node serializer returns an object, never null.

Example:
gpu_type
string | null
gpu_count
integer | null
hostname
string | null
facility_id
string<uuid> | null
cpu_type
string | null
memory_bytes
integer<int64> | null
storage_bytes
integer<int64> | null
ip
string
port
integer | null
username
string
ssh_endpoint
string
enrolled_at
string<date-time>
cleanup_state
string
authorized_key_fingerprints
string[]

Fingerprints of SSH keys installed for the tenant login on this host.

authorized_key_metadata
object[]
keys_pushed_at
string<date-time> | null

When keys were last installed on this host.

reboot
null | object

The latest tracked host reboot, or null.