Réglages FinOps

L'écran Réglages FinOps vous permet de fixer la devise et le budget mensuel de votre tenant, de charger les taux de change et d'enregistrer les prix unitaires datés des médias, du GPU et du stockage. Chemin dans le portail : /finops/settings (menu FinOps > Réglages FinOps). Les analystes FinOps et les administrateurs de tenant modifient les réglages ; les auditeurs les lisent.

Ce que montre l'écran

L'écran a trois onglets : Devise et budget (par défaut), Taux de change (?tab=fxRates) et Prix unitaires (?tab=mediaPrices).

Zone	Contenu
Réglages actuels	JSON des valeurs utilisées aujourd'hui par l'estimation des coûts, les alertes de budget et les réservations de quota : currency, monthly_budget, variance_threshold_pct, reservation_ttl_seconds.
Modifier les réglages	Formulaire : Devise (par exemple EUR), Budget mensuel (par exemple 10000.00), Seuil d'écart (%), Durée de vie des réservations (s), avec un panneau Résultat.
Tableau Taux de change	Filtres Devise de base et Devise cotée. Colonnes : Devise de base, Devise cotée, Taux, Date d'effet, Source. Un clic sur une ligne l'affiche en JSON.
Charger des taux de change	Formulaire avec un seul champ Taux (liste JSON) et un panneau Résultat.
Tableau Prix unitaires des médias, du GPU et du stockage	Filtre Unité (audio_second, image, video_second, gpu_second, storage_gb_month). Colonnes : Unité, Fournisseur, Ressource, Prix unitaire, En vigueur depuis, Source. Un clic sur une ligne l'affiche en JSON.
États vides	Aucun taux de change ; Aucun prix unitaire (un prix inconnu n'est jamais compté comme zéro).

Actions

Bouton ou action	Ce qu'il fait	Appel API	Rôles
Réglages actuels (chargé avec l'onglet)	Lit les réglages du tenant.	GET /v1/finops/settings	Lecteurs de la section FinOps
Exécuter (Modifier les réglages)	Enregistre les champs remplis ; un champ vide garde sa valeur actuelle.	PUT /v1/finops/settings	finops, tenant_admin, platform_admin
Filtrer (Taux de change)	Filtre les taux sur les devises.	GET /v1/finops/fx-rates (base, quote)	Lecteurs de la section FinOps
Exécuter (Charger des taux de change)	Écrit les taux ; un taux existant à la même date est remplacé.	PUT /v1/finops/fx-rates	finops, tenant_admin, platform_admin
Filtrer (prix unitaires)	Filtre les prix sur l'unité.	GET /v1/finops/media-prices (unit)	Lecteurs de la section FinOps
Nouveau prix unitaire	Ouvre le formulaire : Unité (obligatoire), Fournisseur (obligatoire), Ressource (obligatoire), Prix unitaire (obligatoire, par exemple 0.006), Devise (par défaut EUR), En vigueur depuis, Source. Créer l'envoie.	POST /v1/finops/media-prices	finops, tenant_admin, platform_admin
Actualiser (icône flèche ronde)	Recharge le tableau de l'onglet.	GET /v1/finops/fx-rates ou GET /v1/finops/media-prices	Lecteurs de la section FinOps

La valeur par défaut de Taux est :

[{"base": "EUR", "quote": "USD", "rate": "1.08", "as_of": "2026-01-01T00:00:00Z", "source": "ecb"}]

Rôles

Rôle	Accès
finops, tenant_admin	Modifient les réglages, les taux et les prix unitaires (ADMIN_ROLES de services/control-plane/src/eai/domains/finops/__init__.py et de services/control-plane/src/eai/domains/finops/media.py).
platform_admin	Mêmes droits. Les réglages et les prix unitaires exigent un contexte de tenant ; les taux chargés sans tenant sont des taux de la plateforme.
auditor	Lit tous les onglets. Les formulaires affichent Nécessite l'un de ces rôles : FinOps, Admin tenant, Admin plateforme et Nouveau prix unitaire est masqué.
developer, viewer, security_officer	Autorisés en lecture par l'API, mais la section FinOps du menu du portail ne s'ouvre pas pour eux.

Tâches courantes

Fixer la devise et le budget mensuel

1. Lire les valeurs actuelles. Réglages actuels montre ce que l'estimation utilise aujourd'hui. Résultat attendu : le JSON affiche currency et monthly_budget. En cas d'échec : une erreur tenant_required signifie que vous n'êtes pas connecté à un tenant.
2. Remplir le formulaire. Dans Modifier les réglages, saisissez Devise (trois lettres majuscules) et Budget mensuel, que les alertes budget comparent à la dépense. Résultat attendu : les champs sont remplis ; les autres champs peuvent rester vides. En cas d'échec : si le formulaire est remplacé par un avis de rôle, demandez le rôle finops.
3. Enregistrer. Cliquez sur Exécuter. Résultat attendu : le panneau Résultat montre les nouvelles valeurs. Réglages actuels les affiche après un rechargement de la page. En cas d'échec : validation_error signale une devise qui n'est pas en trois lettres majuscules ou une valeur négative.

Charger les taux de change du mois

1. Ouvrir l'onglet. Cliquez sur Taux de change. Les coûts dans une autre devise sont convertis avec le taux valable à leur date. Résultat attendu : la liste des taux s'affiche. En cas d'échec : cliquez sur Actualiser.
2. Coller les taux. Remplacez le JSON Taux par votre liste de base, quote, rate, as_of, source (1 à 1000 taux), puis cliquez sur Exécuter. Résultat attendu : le panneau Résultat montre updated et la liste des taux. En cas d'échec : validation_error nomme l'entrée invalide (un taux doit être supérieur à zéro).

Enregistrer le prix d'une unité média

1. Ouvrir le formulaire. Dans Prix unitaires, cliquez sur Nouveau prix unitaire. Résultat attendu : le formulaire s'ouvre à droite. En cas d'échec : le bouton n'est affiché qu'aux administrateurs FinOps.
2. Remplir et créer. Choisissez l'Unité, saisissez Fournisseur, Ressource, Prix unitaire et Source (le serveur l'exige), puis cliquez sur Créer. Résultat attendu : le message Créé apparaît et le prix est listé. En cas d'échec : media_price_exists signifie qu'une révision existe déjà à cette date ; choisissez une autre date En vigueur depuis.

Dépannage

Symptôme	Cause	Correction
Erreur media_price_invalid (HTTP 422) : « Le champ source du prix média est invalide. »	Source laissé vide, ou un autre champ invalide (le message le nomme).	Remplissez Source et vérifiez le champ nommé.
Erreur media_price_exists (HTTP 409)	Une révision existe pour cette unité, ce fournisseur, cette ressource et cette date.	Choisissez une autre date En vigueur depuis.
Erreur validation_error (HTTP 422)	Devise qui n'est pas en trois lettres majuscules, budget négatif, taux non supérieur à zéro, ou plus de 1000 taux.	Corrigez la valeur.
Réglages actuels affiche les anciennes valeurs	Le bloc est lu à l'ouverture de l'onglet.	Rechargez la page.
Erreur tenant_required (HTTP 403)	Administrateur de plateforme sans tenant sur les réglages ou les prix unitaires.	Connectez-vous à un tenant.
Erreur fx_rate_missing ailleurs dans FinOps	Aucun taux ne couvre la paire de devises à la date d'un coût.	Chargez le taux ici.

Pages liées

• Synthèse
• Grilles tarifaires
• Alertes
• Rapprochement
• Quotas
• Brique moteur de tarification
• Brique registre des coûts