API Nodes

API Nodes

Endpoints pour consulter et gérer les nodes d’un cluster.

Lister les nodes d’un cluster

GET /v1/clusters/{cluster_id}/nodes

Réponse 200 OK :

{
  "items": [
    {
      "id": "node_xyz789",
      "cluster_id": "cls_abc123",
      "name": "cp-1",
      "role": "controlplane",
      "status": "ready",
      "node_size": "large",
      "ip_address": "10.0.1.10",
      "kubernetes_version": "v1.31.0",
      "talos_version": "v1.9.0",
      "created_at": "2026-03-01T10:01:00Z"
    },
    {
      "id": "node_xyz790",
      "cluster_id": "cls_abc123",
      "name": "worker-1",
      "role": "worker",
      "status": "ready",
      "node_size": "large",
      "ip_address": "10.0.1.20",
      "kubernetes_version": "v1.31.0",
      "talos_version": "v1.9.0",
      "created_at": "2026-03-01T10:02:00Z"
    }
  ],
  "total": 2
}

Récupérer un node

GET /v1/clusters/{cluster_id}/nodes/{node_id}

Réponse 200 OK : Objet node complet.

Attributs d’un node

Champ	Type	Description
id	string	Identifiant unique du node
cluster_id	string	ID du cluster parent
name	string	Nom du node
role	string	controlplane ou worker
status	string	État du node
node_size	string	Taille (small/medium/large/xlarge)
ip_address	string	Adresse IP interne
kubernetes_version	string	Version de Kubernetes
talos_version	string	Version de Talos Linux
created_at	string	Date de création (ISO 8601)

Statuts possibles

Statut	Description
provisioning	VM en cours de création
installing	Talos Linux en cours d’installation
joining	Le node rejoint le cluster
ready	Node opérationnel
not_ready	Node non disponible
draining	Évacuation des workloads en cours
deleting	Suppression en cours