Get cluster machine inventory
get_cluster_machine_inventoryCompare every server and bastion record the platform keeps for an Ankra-provisioned cluster (Hetzner, UpCloud, DigitalOcean, AWS, or Ankra Cloud) with what the cloud provider and the Kubernetes Node list say, and classify each record. Use it when a node group counts a worker that is not in the Node list, when unregistered_workers or a stale node / server record / phantom worker is suspected, when a worker sits in creating or stopping for days, or when a stopped cluster's kept machine may have been deleted at the provider. Each row carries name, resource_id, kind, role, node_group, state, parked (a kept row of a stopped cluster), machine_id, provider_answer (present, absent, unknown, or not_asked), node (registered, missing, unknown, or not_applicable) and classification: 'consistent'; 'phantom' (a live row whose machine the provider answered 404 for while answering another machine of the cluster as present in the same pass); 'gone_kept' (the same proof for a parked row); 'no_node' (the machine exists but no Node registered for it past a 30-minute grace); or 'unknown' (no recorded machine id, the provider did not answer, a 404 with no present machine to confirm it, or past the lookup cap). Unknown is never gone: report it as unknown. retirable_resource_ids lists the phantom and gone_kept rows; pass them to retire_gone_machine_rows. nodes_without_row lists Nodes no live record registers as. At most 40 machines are looked up per call, 4 at a time; rows_total and machines_looked_up say when the cap was reached. Runs nothing that changes the cluster or the provider. Not available for imported or managed-Kubernetes clusters, nor (yet) OVH, Scaleway, Proxmox or HPE Morpheus.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_cluster_machine_inventory"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cluster_id | No | UUID of the cluster. Optional when a cluster is selected. | |
| cluster_name | No | Exact name of the cluster. Optional when a cluster is selected. |