io.enterpriseai.resources.PlatformManagerClient

Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/PlatformManagerClient.java. Retour à l'index de la référence du SDK Java.

remarque

Cette page est générée par tools/docs/gen_sdk_reference.py depuis les sources du SDK et les dossiers de textes OpenAPI. Ne la modifiez pas à la main : changez la source et régénérez.

Classe PlatformManagerClient

Platform Manager. Espace Platform Manager de la console : la passerelle du Control Plane vers le Navin Manager, qui installe, connecte et exploite les services de la plateforme sur les machines du client, ainsi que le coffre-fort informatique des administrateurs de la plateforme.

Constructeur PlatformManagerClient

PlatformManagerClient(Transport transport)

Crée le client sur le transport partagé ; EnterpriseAIClient le construit, on y accède par l'accesseur du même nom.

Nom	Type	Défaut	Requis	Description
transport	Transport		oui	Transport partagé par les sous-clients d'un même client.

PlatformManagerClient.approveDrExercise

JsonNode approveDrExercise(String exerciseId)

Approuver un exercice de PRA. Ajoute l'approbation de l'utilisateur à un exercice de PRA ; le Manager refuse l'auto-approbation. Audité (platform_manager.dr.exercise.approve) avec le nouveau statut. Demande platform_admin.

Route : /v1/platform-manager/dr/exercises/{exercise_id}/approve (POST).

Nom	Type	Défaut	Requis	Description
exerciseId	String		oui	Identifiant de l'exercice de PRA dans le Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Approuver un exercice de PRA ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.approveRestore

JsonNode approveRestore(String planId)

Approuver un plan de restauration. Ajoute l'approbation de l'utilisateur à un plan de restauration ; le Manager refuse l'auto-approbation et compte deux approbateurs distincts. Audité (platform_manager.restore.approve) avec le nouveau statut et le nombre d'approbations. Demande platform_admin.

Route : /v1/platform-manager/backup/restores/{plan_id}/approve (POST).

Nom	Type	Défaut	Requis	Description
planId	String		oui	Identifiant du plan de restauration dans le Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Approuver un plan de restauration ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.backupJobs

JsonNode backupJobs()

Lister les tâches de sauvegarde. Tâches de sauvegarde du Manager avec leur statut, relayées au nom de l'utilisateur (backup:read côté Manager). Demande platform_admin.

Route : /v1/platform-manager/backup/jobs (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les tâches de sauvegarde ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.backupPlans

JsonNode backupPlans()

Lister les plans de sauvegarde. Politiques de sauvegarde (périmètre, intervalle, rétention, immuabilité) et alertes de retard ou d'échec du Manager. Demande platform_admin.

Route : /v1/platform-manager/backup/plans (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les plans de sauvegarde ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.backups

JsonNode backups()

Lister les sauvegardes. Sauvegardes avec leur SHA-256, leur taille et le résultat de leur dernière vérification, relayées depuis le Manager (backup:read côté Manager). Demande platform_admin.

Route : /v1/platform-manager/backup/backups (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les sauvegardes ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.catalog

JsonNode catalog()

Lister le catalogue du Manager. Services du catalogue du Manager (nom, version et catégories de la pile) avec leurs noms affichés, catégorie, version, composants, modes, méthodes, prérequis, mode de livraison (install, connect, job, package), couche et licence. Demande platform_admin.

Route : /v1/platform-manager/catalog (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister le catalogue du Manager ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.catalogService

JsonNode catalogService(String service)

Lire le descripteur d'installation d'un service. Descripteur d'installation d'un service du catalogue : modes avec leurs composants et cardinalités, méthodes, prérequis, sections et paramètres avec leurs valeurs par défaut. Un paramètre secret ne porte jamais de valeur par défaut et indique s'il est généré ; les gabarits et artefacts ne sortent jamais de la passerelle. Demande platform_admin.

Route : /v1/platform-manager/catalog/{service} (GET).

Nom	Type	Défaut	Requis	Description
service	String		oui	Nom du service du catalogue.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire le descripteur d'installation d'un service ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.clusters

JsonNode clusters()

Lister les clusters. Clusters (environnements) du Navin Manager visibles par l'utilisateur. Demande platform_admin.

Route : /v1/platform-manager/clusters (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les clusters ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.connect

JsonNode connect(String clusterId, Object body)

Connecter un service existant. Enregistre un service existant du client au nom de l'utilisateur et répond 201 ; le Manager contrôle services:install et la section de connexion du descripteur, puis vérifie sa santé. Un service connecté n'est jamais installé, démarré ni arrêté par le Manager. Les champs secrets sont relayés et scellés par le Manager ; l'audit ne garde que le point d'accès, le TLS, la méthode et les noms des champs. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services/connect (POST).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
body	Object		oui	Le service à connecter.

Retour : JsonNode. Réponse JSON décodée de l'opération « Connecter un service existant ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.connections

JsonNode connections(Map<String, ?> query)

Lister les connexions. Connexions existantes des types que le portail lie (PostgreSQL, Redis, OIDC), filtrées par type si fourni ; le secret indique seulement s'il est renseigné. Demande connections:read dans le Manager. Demande platform_admin.

Route : /v1/platform-manager/connections (GET).

Nom	Type	Défaut	Requis	Description
query	Map<String, ?>		oui	Paramètres de la chaîne de requête de la route.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les connexions ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.console

JsonNode console()

Obtenir les liens des consoles. Indique si le Manager est configuré, l'adresse de base de sa console (EAI_PLATFORM_MANAGER_CONSOLE_URL, sinon EAI_PLATFORM_MANAGER_URL) et les consoles d'exploitation (Opik, Grafana, Keycloak, LiteLLM, OpenSearch Dashboards) : depuis leur paramètre s'il est renseigné (source setting), sinon depuis le service du même nom installé ou connecté par le Manager (source manager). Une adresse de console qui n'est pas en https ou qui porte des identifiants n'est jamais renvoyée (problem en donne la raison). Demande platform_admin.

Route : /v1/platform-manager/console (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Obtenir les liens des consoles ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.createCluster

JsonNode createCluster(Object body)

Créer un cluster. Crée un cluster (environnement) dans le Manager et répond 201 ; l'utilisateur délégué doit détenir clusters:create. Audité (platform_manager.cluster_create), autorisé ou refusé. Demande platform_admin.

Route : /v1/platform-manager/clusters (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	Nom, mode, description et profil du cluster.

Retour : JsonNode. Réponse JSON décodée de l'opération « Créer un cluster ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.createConnection

JsonNode createConnection(Object body)

Enregistrer une connexion. Enregistre un PostgreSQL, un Redis ou un émetteur OIDC existant comme connexion du Manager et répond 201 (le secret est scellé par le Manager et jamais renvoyé). Les formulaires d'installation y lient ensuite un service. Demande connections:manage dans le Manager. L'audit garde nom, type, clés des paramètres et présence d'un secret. Demande platform_admin.

Route : /v1/platform-manager/connections (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	La connexion à enregistrer.

Retour : JsonNode. Réponse JSON décodée de l'opération « Enregistrer une connexion ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.createEnrollmentToken

JsonNode createEnrollmentToken(String clusterId, Object body)

Créer un jeton d'enrôlement. Jeton d'amorçage de l'agent de nœud et commande d'enregistrement à lancer sur chaque machine, renvoyés avec 201 ; affichés une seule fois, le jeton et la commande ne sont jamais écrits dans l'audit (seuls son identifiant et son échéance). Demande hosts:manage dans le Manager. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/enrollment-tokens (POST).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
body	Object		oui	Durée de vie et nombre d'utilisations du jeton.

Retour : JsonNode. Réponse JSON décodée de l'opération « Créer un jeton d'enrôlement ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.createVaultEntry

JsonNode createVaultEntry(Object body)

Ajouter une entrée au coffre-fort. Ajoute un service au coffre-fort informatique (source manual) et répond 201 sans le mot de passe ni la clé. URL, identifiant, mot de passe et clé sont scellés ensemble en AES-256-GCM (clé dérivée de la clé maîtresse de la plateforme, identifiant de l'entrée comme données associées) ; seul le nom est enregistré en clair. Un nom déjà utilisé répond 409 it_vault_name_taken ; un nom vide 422 validation_failed. Audité (it_vault.create, nom seulement). Demande platform_admin.

Route : /v1/platform-manager/vault/entries (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	Le service à ajouter. Les champs inconnus sont refusés.

Retour : JsonNode. Réponse JSON décodée de l'opération « Ajouter une entrée au coffre-fort ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.decommissionHost

JsonNode decommissionHost(String hostId)

Retirer une machine. Retire une machine sans composants (agent arrêté, certificat révoqué) et répond 202 avec l'identifiant de l'opération. Audité (platform_manager.decommission), autorisé ou refusé. Demande platform_admin.

Route : /v1/platform-manager/hosts/{host_id}/decommission (POST).

Nom	Type	Défaut	Requis	Description
hostId	String		oui	Identifiant de la machine dans le Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Retirer une machine ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.deleteConnection

void deleteConnection(String connectionId)

Supprimer une connexion. Oublie une connexion et répond 204 ; le Manager refuse (409 platform_manager_connection_in_use) tant qu'un service y est lié. Demande connections:manage dans le Manager. Audité, autorisé ou refusé. Demande platform_admin.

Route : /v1/platform-manager/connections/{connection_id} (DELETE).

Nom	Type	Défaut	Requis	Description
connectionId	String		oui	Identifiant de la connexion dans le Manager.

Retour : void.

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.deleteVaultEntry

JsonNode deleteVaultEntry(String entryId)

Supprimer une entrée du coffre-fort. Supprime un service du coffre-fort informatique et répond 204. Une entrée pré-remplie à partir des paramètres de la plateforme revient au prochain import. Audité (it_vault.delete, nom seulement). Identifiant inconnu : 404 it_vault_entry_not_found. Demande platform_admin.

Route : /v1/platform-manager/vault/entries/{entry_id} (DELETE).

Nom	Type	Défaut	Requis	Description
entryId	String		oui	Identifiant (UUID) de l'entrée du coffre-fort.

Retour : JsonNode. Réponse JSON décodée de l'opération « Supprimer une entrée du coffre-fort ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.disconnect

JsonNode disconnect(String clusterId, String service)

Déconnecter un service connecté. Oublie un service connecté (le service lui-même n'est pas touché) ; le Manager refuse tant qu'un consommateur l'utilise. Audité (platform_manager.disconnect), autorisé ou refusé. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services/{service}/connection (DELETE).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
service	String		oui	Nom du service connecté.

Retour : JsonNode. Réponse JSON décodée de l'opération « Déconnecter un service connecté ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.drExercises

JsonNode drExercises()

Lister les exercices de PRA. Exercices de PRA avec le RPO et le RTO observés et l'atteinte de chaque objectif (null quand non mesuré). Demande platform_admin.

Route : /v1/platform-manager/dr/exercises (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les exercices de PRA ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.drPlans

JsonNode drPlans()

Lister les plans de PRA. Plans de PRA : mode, sites principal et secondaire, objectifs de RPO et de RTO du client (null tant qu'ils ne sont pas fixés). Demande platform_admin.

Route : /v1/platform-manager/dr/plans (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les plans de PRA ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.enrollmentTokens

JsonNode enrollmentTokens(String clusterId)

Lister les jetons d'enrôlement. Jetons d'amorçage d'un cluster : préfixe, échéance, utilisations et révocation (le jeton lui-même n'est jamais listé). Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/enrollment-tokens (GET).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les jetons d'enrôlement ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.host

JsonNode host(String hostId)

Lire une machine. Une machine avec ses caractéristiques (système d'exploitation, ressources, version de l'agent, dernier signal de vie). Demande platform_admin.

Route : /v1/platform-manager/hosts/{host_id} (GET).

Nom	Type	Défaut	Requis	Description
hostId	String		oui	Identifiant de la machine dans le Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire une machine ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.importVault

JsonNode importVault()

Importer les services configurés dans le coffre-fort. Pré-remplit le coffre-fort avec les services avec lesquels la plateforme est configurée (PostgreSQL, Redis, Keycloak, OpenBao, OpenFGA, OPA, LiteLLM, Qdrant, NATS, Temporal, LiveKit, Opik, ClickHouse, S3, Platform Manager, compte d'installation du portail), à partir des paramètres EAI_*. Seuls les services manquants sont ajoutés : une entrée n'est jamais écrasée, une entrée supprimée revient. Répond les noms créés et ignorés. Audité (it_vault.import). Le même import s'exécute à chaque démarrage de l'API. Demande platform_admin.

Route : /v1/platform-manager/vault/import (POST).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Importer les services configurés dans le coffre-fort ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.install

JsonNode install(String clusterId, Object body)

Installer des services du catalogue. Installe des services du catalogue sur les hôtes choisis, au nom de l'utilisateur, et répond 202 avec l'identifiant de l'opération ; le Manager contrôle services:install, les modes, méthodes, placements et la configuration, puis lance l'opération d'installation. L'audit garde services, modes, méthodes, hôtes et clés configurées, jamais les valeurs de configuration. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services (POST).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
body	Object		oui	Services à installer et options d'installation.

Retour : JsonNode. Réponse JSON décodée de l'opération « Installer des services du catalogue ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.install

JsonNode install(String clusterId, Object body, RequestOptions options)

Installer des services du catalogue. Installe des services du catalogue sur les hôtes choisis, au nom de l'utilisateur, et répond 202 avec l'identifiant de l'opération ; le Manager contrôle services:install, les modes, méthodes, placements et la configuration, puis lance l'opération d'installation. L'audit garde services, modes, méthodes, hôtes et clés configurées, jamais les valeurs de configuration. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services (POST).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
body	Object		oui	Services à installer et options d'installation.
options	RequestOptions		oui	Options de l'appel (clé d'idempotence, traceparent, en-têtes, signal d'annulation).

Retour : JsonNode. Réponse JSON décodée de l'opération « Installer des services du catalogue ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.nodes

JsonNode nodes(String clusterId)

Lister les machines d'un cluster. Hôtes du cluster tels que le Manager les connaît (état, caractéristiques, agent). Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/nodes (GET).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les machines d'un cluster ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.operations

JsonNode operations(String clusterId)

Lister les opérations d'un cluster. Opérations du Manager sur le cluster (installation, démarrage, arrêt, contrôles préalables, amorçage...) avec leur cible et leur statut. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/operations (GET).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les opérations d'un cluster ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.planRestore

JsonNode planRestore(Object body)

Planifier une restauration. Planifie la restauration d'une sauvegarde et répond 201 avec le plan ; le plan précède toujours une exécution et demande deux approbateurs autres que le demandeur. Le Manager compare les versions cibles avec la sauvegarde. L'exécution de la restauration reste dans la console du Manager. Audité (platform_manager.restore.plan), autorisé ou refusé. Demande platform_admin.

Route : /v1/platform-manager/backup/restores (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	Sauvegarde à restaurer et environnement cible.

Retour : JsonNode. Réponse JSON décodée de l'opération « Planifier une restauration ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.preflightResults

JsonNode preflightResults(String hostId)

Lire les résultats des contrôles préalables. Résultats des derniers contrôles préalables d'une machine (contrôle, statut, message dans les deux langues). Demande platform_admin.

Route : /v1/platform-manager/hosts/{host_id}/preflight (GET).

Nom	Type	Défaut	Requis	Description
hostId	String		oui	Identifiant de la machine dans le Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire les résultats des contrôles préalables ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.refreshFacts

JsonNode refreshFacts(String hostId)

Actualiser les caractéristiques d'une machine. Demande à l'agent de nœud de collecter à nouveau les caractéristiques de la machine (système d'exploitation, ressources...) et répond 202 avec l'identifiant de l'opération. Audité (platform_manager.facts_refresh), autorisé ou refusé. Demande platform_admin.

Route : /v1/platform-manager/hosts/{host_id}/facts/refresh (POST).

Nom	Type	Défaut	Requis	Description
hostId	String		oui	Identifiant de la machine dans le Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Actualiser les caractéristiques d'une machine ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.requestDrExercise

JsonNode requestDrExercise(Object body)

Demander un exercice de PRA. Demande un exercice de PRA d'un plan de PRA et répond 201 ; le Manager applique sa règle d'approbation (dr:manage côté Manager). La conclusion de l'exercice et une bascule réelle restent dans la console du Manager. Audité (platform_manager.dr.exercise.request), autorisé ou refusé. Demande platform_admin.

Route : /v1/platform-manager/dr/exercises (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	Le plan de PRA à exercer.

Retour : JsonNode. Réponse JSON décodée de l'opération « Demander un exercice de PRA ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.requestOperation

JsonNode requestOperation(String clusterId, String service, Object body)

Demander une opération sur un service. Transmet une opération (démarrage, arrêt, redémarrage, redémarrage progressif, réinstallation) avec l'identité de l'utilisateur et répond 202 avec l'identifiant de l'opération ; le Manager décide (RBAC, approbations, règles d'arrêt). Audité (platform_manager.<action>), autorisé ou refusé. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services/{service}/operations (POST).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
service	String		oui	Nom du service.
body	Object		oui	L'opération et sa portée.

Retour : JsonNode. Réponse JSON décodée de l'opération « Demander une opération sur un service ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.requestOperation

JsonNode requestOperation(String clusterId, String service, Object body, RequestOptions options)

Demander une opération sur un service. Transmet une opération (démarrage, arrêt, redémarrage, redémarrage progressif, réinstallation) avec l'identité de l'utilisateur et répond 202 avec l'identifiant de l'opération ; le Manager décide (RBAC, approbations, règles d'arrêt). Audité (platform_manager.<action>), autorisé ou refusé. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services/{service}/operations (POST).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
service	String		oui	Nom du service.
body	Object		oui	L'opération et sa portée.
options	RequestOptions		oui	Options de l'appel (clé d'idempotence, traceparent, en-têtes, signal d'annulation).

Retour : JsonNode. Réponse JSON décodée de l'opération « Demander une opération sur un service ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.requestSupportBundle

JsonNode requestSupportBundle(String clusterId)

Demander un paquet de support. Demande au Manager un paquet de support assaini (cluster:manage côté Manager) et répond 202 avec l'opération à suivre et l'identifiant du paquet ; le paquet se télécharge depuis la console du Manager. Audité (platform_manager.support_bundle), autorisé ou refusé. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/support-bundles (POST).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Demander un paquet de support ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.restores

JsonNode restores()

Lister les plans de restauration. Plans de restauration avec leur statut et leur nombre d'approbations (deux approbateurs autres que le demandeur). Demande platform_admin.

Route : /v1/platform-manager/backup/restores (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les plans de restauration ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.revokeEnrollmentToken

void revokeEnrollmentToken(String clusterId, String tokenId)

Révoquer un jeton d'enrôlement. Révoque un jeton d'amorçage de l'agent de nœud dans le Manager (hosts:manage côté Manager) et répond 204 ; les machines déjà enrôlées ne sont pas touchées. Audité (platform_manager.enrollment_token_revoke), autorisé ou refusé. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/enrollment-tokens/{token_id} (DELETE).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
tokenId	String		oui	Identifiant du jeton d'enrôlement, tel que listé.

Retour : void.

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.runPreflight

JsonNode runPreflight(String hostId)

Lancer les contrôles préalables. Lance les contrôles préalables d'une machine (opération Manager host.preflight, hosts:manage côté Manager) et répond 202 avec l'identifiant de l'opération ; lisez les résultats avec GET .../preflight. Audité, autorisé ou refusé. Demande platform_admin.

Route : /v1/platform-manager/hosts/{host_id}/preflight (POST).

Nom	Type	Défaut	Requis	Description
hostId	String		oui	Identifiant de la machine dans le Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lancer les contrôles préalables ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.service

JsonNode service(String clusterId, String service)

Lire la fiche d'un service. Un service avec ses champs d'état et ses nombres d'instances, son état de sécurité (TLS, nombre de secrets renseignés sur le total) et la fiche complète du Manager. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services/{service} (GET).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
service	String		oui	Nom du service.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire la fiche d'un service ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.serviceConfig

JsonNode serviceConfig(String clusterId, String service)

Lire la configuration d'un service. Version de configuration courante d'un service telle que le Manager la présente (valeurs secrètes masquées), avec recommandations, groupes et hôtes en retard. Demande configs:read dans le Manager ; la modification reste dans la console du Manager. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services/{service}/config (GET).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
service	String		oui	Nom du service.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire la configuration d'un service ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.serviceConfigDiff

JsonNode serviceConfigDiff(String clusterId, String service, Map<String, ?> query)

Comparer deux versions de configuration. Paramètres modifiés entre deux versions de configuration d'un service, une entrée par paramètre ; un paramètre secret indique seulement s'il est renseigné dans chaque version, jamais sa valeur. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services/{service}/config/diff (GET).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
service	String		oui	Nom du service.
query	Map<String, ?>		oui	Paramètres de la chaîne de requête de la route.

Retour : JsonNode. Réponse JSON décodée de l'opération « Comparer deux versions de configuration ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.serviceConfigVersions

JsonNode serviceConfigVersions(String clusterId, String service)

Lister les versions de configuration. Historique des versions de configuration d'un service dans le Manager (configs:read côté Manager). Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services/{service}/config/versions (GET).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
service	String		oui	Nom du service.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les versions de configuration ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.serviceDashboard

JsonNode serviceDashboard(String clusterId, String service, Map<String, ?> query)

Lire le tableau de bord d'un service. Tableau de bord de supervision d'un service relayé depuis le Manager (cluster:read côté Manager) : instances, santé et derniers contrôles, disponibilité, machines détectées avec leurs composants et métriques, alertes, opérations, configuration et, pour un service connecté, sa connexion. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services/{service}/dashboard (GET).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
service	String		oui	Nom du service.
query	Map<String, ?>		oui	Paramètres de la chaîne de requête de la route.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire le tableau de bord d'un service ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.services

JsonNode services(String clusterId)

Lister les services d'un cluster. Services du cluster avec les cinq champs d'état (souhaité, observé, santé, opération, sécurité), l'état administratif et sa raison, le nombre d'instances démarrées et total, drift (l'observé diffère du souhaité), le mode de livraison et la connexion d'un service connecté. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services (GET).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les services d'un cluster ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.setMode

JsonNode setMode(String clusterId, String service, Object body)

Définir le mode d'exploitation d'un service. Mode d'exploitation d'un service (drainage, mise à zéro, suspension de sécurité, arrêt d'urgence, désactivation, quarantaine, maintenance, activation), transmis au nom de l'utilisateur ; le Manager fait respecter l'état qui en résulte et peut exiger une approbation. Audité (platform_manager.mode.<mode>) avec l'identifiant de l'opération et l'état administratif obtenu, autorisé ou refusé. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services/{service}/mode (POST).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
service	String		oui	Nom du service.
body	Object		oui	Le mode à appliquer et ses options.

Retour : JsonNode. Réponse JSON décodée de l'opération « Définir le mode d'exploitation d'un service ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.setup

JsonNode setup()

Lire l'état de mise en route. État de mise en route, sans jamais de secret ni d'erreur si le Manager est absent. core : API, PostgreSQL, migrations, Redis (facultatif) et Keycloak (facultatif), chacun avec un état (ok, missing, down, error), le paramètre à corriger et des messages en anglais et en français. manager : adresse et référence du jeton renseignées, identifiant trouvé, Manager joignable, utilisateur délégué connu, nombre de clusters, référence de jeton suggérée et permissions nécessaires au jeton d'API du Manager (les changements demandent un redémarrage). Demande platform_admin.

Route : /v1/platform-manager/setup (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire l'état de mise en route ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.sshBootstrap

JsonNode sshBootstrap(String clusterId, Object body)

Installer l'agent de nœud par SSH. Installe l'agent de nœud sur des machines par SSH (opération Manager host.ssh_bootstrap, hosts:manage côté Manager) et répond 202 avec l'opération à suivre. La clé privée est relayée au Manager, qui la garde en mémoire pour les seules tâches d'amorçage ; le Control Plane ne l'enregistre ni ne l'audite jamais (l'audit garde hôtes, utilisateur, port, sudo et empreintes). Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/hosts/ssh-bootstrap (POST).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
body	Object		oui	Machines, compte SSH et empreintes des clés d'hôte.

Retour : JsonNode. Réponse JSON décodée de l'opération « Installer l'agent de nœud par SSH ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.summary

JsonNode summary()

Lire la synthèse de la plateforme. Décomptes réels par cluster (environnement) : services au total, sains, en avertissement, en échec ; hôtes ; alertes ; opérations. Demande platform_admin.

Route : /v1/platform-manager/summary (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire la synthèse de la plateforme ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.supportBundles

JsonNode supportBundles(String clusterId)

Lister les paquets de support. Paquets de support assainis d'un cluster ; un paquet se télécharge depuis la console du Manager, jamais par le Control Plane. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/support-bundles (GET).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les paquets de support ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.testConnection

JsonNode testConnection(String connectionId)

Tester une connexion enregistrée. Lance tout de suite le test du protocole d'une connexion enregistrée (son secret scellé reste dans le Manager). Audité. Demande platform_admin.

Route : /v1/platform-manager/connections/{connection_id}/test (POST).

Nom	Type	Défaut	Requis	Description
connectionId	String		oui	Identifiant de la connexion dans le Manager.

Retour : JsonNode. Réponse JSON décodée de l'opération « Tester une connexion enregistrée ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.updateVaultEntry

JsonNode updateVaultEntry(String entryId, Object body)

Modifier une entrée du coffre-fort. Modifie les champs fournis d'une entrée du coffre-fort et les scelle à nouveau (AES-256-GCM). Un nom utilisé par une autre entrée (sans tenir compte de la casse) répond 409 it_vault_name_taken ; un nom vide 422 validation_failed. Audité (it_vault.update, nom et noms des champs modifiés seulement). Demande platform_admin.

Route : /v1/platform-manager/vault/entries/{entry_id} (PATCH).

Nom	Type	Défaut	Requis	Description
entryId	String		oui	Identifiant (UUID) de l'entrée du coffre-fort.
body	Object		oui	Champs à modifier. Les champs inconnus sont refusés.

Retour : JsonNode. Réponse JSON décodée de l'opération « Modifier une entrée du coffre-fort ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.validateConnect

JsonNode validateConnect(String clusterId, Object body)

Valider la connexion d'un service. Simulation d'une connexion par le Manager : répond ok, les erreurs (service, champ, code, messages dans les deux langues) et le résultat du contrôle de santé ; rien n'est enregistré. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services/connect/validate (POST).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
body	Object		oui	Le service à connecter, comme pour la connexion réelle.

Retour : JsonNode. Réponse JSON décodée de l'opération « Valider la connexion d'un service ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.validateConnection

JsonNode validateConnection(Object body)

Tester une connexion avant de l'enregistrer. Test réel du protocole d'une connexion avant son enregistrement : répond ok, la latence en millisecondes, la version du serveur, le code d'erreur et les messages ; rien n'est enregistré et le secret n'est jamais renvoyé. Audité sans le secret. Demande platform_admin.

Route : /v1/platform-manager/connections/validate (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	Type, paramètres et secret de la connexion à tester.

Retour : JsonNode. Réponse JSON décodée de l'opération « Tester une connexion avant de l'enregistrer ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.validateInstall

JsonNode validateInstall(String clusterId, Object body)

Valider une installation de services. Simulation d'une installation par le planificateur du Manager : répond ok, les erreurs (service, champ, code, messages dans les deux langues) et le plan qu'il exécuterait ; rien n'est installé. Demande platform_admin.

Route : /v1/platform-manager/clusters/{cluster_id}/services/validate (POST).

Nom	Type	Défaut	Requis	Description
clusterId	String		oui	Identifiant du cluster dans le Navin Manager.
body	Object		oui	L'installation à contrôler, comme pour l'installation réelle.

Retour : JsonNode. Réponse JSON décodée de l'opération « Valider une installation de services ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.vaultEntries

JsonNode vaultEntries()

Lister les entrées du coffre-fort. Services du coffre-fort informatique par nom, avec URL, identifiant de connexion, source (manual ou installed:<service>) et présence d'un mot de passe et d'une clé (has_password, has_api_key), jamais leurs valeurs. Demande platform_admin.

Route : /v1/platform-manager/vault/entries (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les entrées du coffre-fort ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.vaultEntry

JsonNode vaultEntry(String entryId)

Lire une entrée du coffre-fort. Un service du coffre-fort sans son mot de passe ni sa clé (utilisez POST .../reveal pour les obtenir). Identifiant inconnu : 404 it_vault_entry_not_found. Demande platform_admin.

Route : /v1/platform-manager/vault/entries/{entry_id} (GET).

Nom	Type	Défaut	Requis	Description
entryId	String		oui	Identifiant (UUID) de l'entrée du coffre-fort.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire une entrée du coffre-fort ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PlatformManagerClient.vaultReveal

JsonNode vaultReveal(String entryId)

Révéler les secrets d'une entrée du coffre-fort. Mot de passe et clé d'un service en clair (affichage et copie dans la console). Chaque révélation est auditée (it_vault.reveal) avec le nom du service, jamais les valeurs. Identifiant inconnu : 404 it_vault_entry_not_found. Demande platform_admin.

Route : /v1/platform-manager/vault/entries/{entry_id}/reveal (POST).

Nom	Type	Défaut	Requis	Description
entryId	String		oui	Identifiant (UUID) de l'entrée du coffre-fort.

Retour : JsonNode. Réponse JSON décodée de l'opération « Révéler les secrets d'une entrée du coffre-fort ».

Erreurs levées : les erreurs typées du transport (Erreurs).