List instance types (server sizes) with vCPUs, RAM, disk and price. Without cluster_id this is the offline catalogue: snapshot prices and NO availability - a type listed here can be out of stock in a location, so never treat it as orderable. With cluster_id it reads the live stock at that cluster's location through the cluster's own credential (Hetzner today; other providers answer the catalogue marked availability unknown): every type carries available, and available=false means it cannot be created there now. To right-size or grow a cluster: read the workloads' requests first (the pods on the group's nodes and their CPU/memory requests), then call this with cluster_id, then propose the cheapest available type whose allocatable (a little under its RAM) fits the busiest node's summed requests. Never propose a type with available=false; update_node_group and add_node_group refuse one before the card is raised. Also use it to help the user choose control plane, worker and bastion sizes for a new cluster. The catalogue covers Hetzner, OVH, UpCloud and Scaleway only: this tool lists no DigitalOcean, AWS or Ankra Cloud sizes yet (the portal's create and node-group forms read those live from the provider).
ConnectorOAuth