Skip to main content
GET
Fleet Inventory

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

fleet_id
string
required

Query Parameters

refresh
boolean
default:false

Ask the backend now instead of serving the cached observation.

Response

Successful Response

One observation, carrying enough provenance to be read correctly.

The four statuses are four different facts and are never rounded into each other -- which is the defect this contract replaces, where a Kubernetes API that could not be reached produced the same empty capacity as a cluster with nothing in it:

fresh the backend answered completely; zero resources means zero stale it could not be reached now, and these were seen at observed_at unknown it could not be reached and nothing earlier is held. Nothing may be concluded from this -- not emptiness, and not insufficiency partial some resources were reported; an absent one is not proven gone

fleet_id
string
required
source
enum<string>
required
Available options:
node,
kubernetes,
slurm
status
enum<string>
required
Available options:
fresh,
stale,
unknown,
partial
checked_at
string
required
observed_at
string | null
resources
InventoryResourceOut · object[]
problem
InventoryProblemOut · object | null

Why an observation is incomplete. Sanitized before it leaves the server.

accelerators_by_series
Accelerators By Series · object
machine_count
integer
default:0
unreported_machines
integer
default:0