platform_manager.go (package eai)
Source : sdks/go/platform_manager.go. Retour à l'index de la référence du SDK Go.
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 PlatformManagerService
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.
PlatformManagerService.ApproveDRExercise
ApproveDRExercise(ctx context.Context, exerciseID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
exerciseID | string | oui | Identifiant de l'exercice de PRA dans le Manager. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Approuver un exercice de PRA ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.ApproveRestore
ApproveRestore(ctx context.Context, planID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
planID | string | oui | Identifiant du plan de restauration dans le Manager. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Approuver un plan de restauration ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.BackupJobs
BackupJobs(ctx context.Context, opts ...CallOption) (json.RawMessage, error)
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).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les tâches de sauvegarde ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.BackupPlans
BackupPlans(ctx context.Context, opts ...CallOption) (json.RawMessage, error)
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).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les plans de sauvegarde ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Backups
Backups(ctx context.Context, opts ...CallOption) (json.RawMessage, error)
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).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les sauvegardes ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Catalog
Catalog(ctx context.Context, opts ...CallOption) (json.RawMessage, error)
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).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister le catalogue du Manager ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.CatalogService
CatalogService(ctx context.Context, service string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
service | string | oui | Nom du service du catalogue. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lire le descripteur d'installation d'un service ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Clusters
Clusters(ctx context.Context, opts ...CallOption) (json.RawMessage, error)
Lister les clusters. Clusters (environnements) du Navin Manager visibles par l'utilisateur. Demande platform_admin.
Route : /v1/platform-manager/clusters (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les clusters ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Connect
Connect(ctx context.Context, clusterID string, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
body | any | oui | Le service à connecter. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Connecter un service existant ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Connections
Connections(ctx context.Context, connType string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
connType | string | oui | Type de connexion à garder (postgresql, redis ou oidc), envoyé dans le paramètre de requête type ; vide pour tous les types. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les connexions ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Console
Console(ctx context.Context, opts ...CallOption) (json.RawMessage, error)
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).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Obtenir les liens des consoles ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.CreateCluster
CreateCluster(ctx context.Context, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
body | any | oui | Nom, mode, description et profil du cluster. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Créer un cluster ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.CreateConnection
CreateConnection(ctx context.Context, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
body | any | oui | La connexion à enregistrer. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Enregistrer une connexion ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.CreateEnrollmentToken
CreateEnrollmentToken(ctx context.Context, clusterID string, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
body | any | oui | Durée de vie et nombre d'utilisations du jeton. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Créer un jeton d'enrôlement ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.CreateVaultEntry
CreateVaultEntry(ctx context.Context, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
body | any | oui | Le service à ajouter. Les champs inconnus sont refusés. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Ajouter une entrée au coffre-fort ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.DRExercises
DRExercises(ctx context.Context, opts ...CallOption) (json.RawMessage, error)
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).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les exercices de PRA ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.DRPlans
DRPlans(ctx context.Context, opts ...CallOption) (json.RawMessage, error)
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).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les plans de PRA ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.DecommissionHost
DecommissionHost(ctx context.Context, hostID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
hostID | string | oui | Identifiant de la machine dans le Manager. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Retirer une machine ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.DeleteConnection
DeleteConnection(ctx context.Context, connectionID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
connectionID | string | oui | Identifiant de la connexion dans le Manager. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Supprimer une connexion ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.DeleteVaultEntry
DeleteVaultEntry(ctx context.Context, entryID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
entryID | string | oui | Identifiant (UUID) de l'entrée du coffre-fort. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Supprimer une entrée du coffre-fort ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Disconnect
Disconnect(ctx context.Context, clusterID string, service string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
service | string | oui | Nom du service connecté. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Déconnecter un service connecté ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.EnrollmentTokens
EnrollmentTokens(ctx context.Context, clusterID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les jetons d'enrôlement ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Host
Host(ctx context.Context, hostID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
hostID | string | oui | Identifiant de la machine dans le Manager. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lire une machine ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.ImportVault
ImportVault(ctx context.Context, opts ...CallOption) (json.RawMessage, error)
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).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Importer les services configurés dans le coffre-fort ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Install
Install(ctx context.Context, clusterID string, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
body | any | oui | Services à installer et options d'installation. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Installer des services du catalogue ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Nodes
Nodes(ctx context.Context, clusterID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les machines d'un cluster ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Operations
Operations(ctx context.Context, clusterID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les opérations d'un cluster ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.PlanRestore
PlanRestore(ctx context.Context, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
body | any | oui | Sauvegarde à restaurer et environnement cible. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Planifier une restauration ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.PreflightResults
PreflightResults(ctx context.Context, hostID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
hostID | string | oui | Identifiant de la machine dans le Manager. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lire les résultats des contrôles préalables ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.RefreshFacts
RefreshFacts(ctx context.Context, hostID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
hostID | string | oui | Identifiant de la machine dans le Manager. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Actualiser les caractéristiques d'une machine ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.RequestDRExercise
RequestDRExercise(ctx context.Context, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
body | any | oui | Le plan de PRA à exercer. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Demander un exercice de PRA ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.RequestOperation
RequestOperation(ctx context.Context, clusterID string, service string, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
service | string | oui | Nom du service. | |
body | any | oui | L'opération et sa portée. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Demander une opération sur un service ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Restores
Restores(ctx context.Context, opts ...CallOption) (json.RawMessage, error)
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).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les plans de restauration ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.RevokeEnrollmentToken
RevokeEnrollmentToken(ctx context.Context, clusterID string, tokenID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
tokenID | string | oui | Identifiant du jeton d'enrôlement, tel que listé. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Révoquer un jeton d'enrôlement ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.RunPreflight
RunPreflight(ctx context.Context, hostID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
hostID | string | oui | Identifiant de la machine dans le Manager. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lancer les contrôles préalables ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.SSHBootstrap
SSHBootstrap(ctx context.Context, clusterID string, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
body | any | oui | Machines, compte SSH et empreintes des clés d'hôte. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Installer l'agent de nœud par SSH ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Service
Service(ctx context.Context, clusterID string, service string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
service | string | oui | Nom du service. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lire la fiche d'un service ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.ServiceConfig
ServiceConfig(ctx context.Context, clusterID string, service string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
service | string | oui | Nom du service. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lire la configuration d'un service ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.ServiceConfigVersions
ServiceConfigVersions(ctx context.Context, clusterID string, service string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
service | string | oui | Nom du service. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les versions de configuration ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Services
Services(ctx context.Context, clusterID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les services d'un cluster ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.SetMode
SetMode(ctx context.Context, clusterID string, service string, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
service | string | oui | Nom du service. | |
body | any | oui | Le mode à appliquer et ses options. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Définir le mode d'exploitation d'un service ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Setup
Setup(ctx context.Context, opts ...CallOption) (json.RawMessage, error)
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).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lire l'état de mise en route ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.Summary
Summary(ctx context.Context, opts ...CallOption) (json.RawMessage, error)
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).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lire la synthèse de la plateforme ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.TestConnection
TestConnection(ctx context.Context, connectionID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
connectionID | string | oui | Identifiant de la connexion dans le Manager. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Tester une connexion enregistrée ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.UpdateVaultEntry
UpdateVaultEntry(ctx context.Context, entryID string, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
entryID | string | oui | Identifiant (UUID) de l'entrée du coffre-fort. | |
body | any | oui | Champs à modifier. Les champs inconnus sont refusés. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Modifier une entrée du coffre-fort ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.ValidateConnect
ValidateConnect(ctx context.Context, clusterID string, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
body | any | oui | Le service à connecter, comme pour la connexion réelle. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Valider la connexion d'un service ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.ValidateConnection
ValidateConnection(ctx context.Context, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
body | any | oui | Type, paramètres et secret de la connexion à tester. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Tester une connexion avant de l'enregistrer ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.ValidateInstall
ValidateInstall(ctx context.Context, clusterID string, body any, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
clusterID | string | oui | Identifiant du cluster dans le Navin Manager. | |
body | any | oui | L'installation à contrôler, comme pour l'installation réelle. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Valider une installation de services ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.VaultEntries
VaultEntries(ctx context.Context, opts ...CallOption) (json.RawMessage, error)
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).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les entrées du coffre-fort ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.VaultEntry
VaultEntry(ctx context.Context, entryID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
entryID | string | oui | Identifiant (UUID) de l'entrée du coffre-fort. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lire une entrée du coffre-fort ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).
PlatformManagerService.VaultReveal
VaultReveal(ctx context.Context, entryID string, opts ...CallOption) (json.RawMessage, error)
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 |
|---|---|---|---|---|
ctx | context.Context | oui | Contexte de l'appel : annulation et échéance. | |
entryID | string | oui | Identifiant (UUID) de l'entrée du coffre-fort. | |
opts | ...CallOption | non | Options de l'appel (requête, clé d'idempotence, traceparent, en-têtes). |
Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Révéler les secrets d'une entrée du coffre-fort ». L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error, les erreurs typées du transport (Erreurs).