Quotas

L'écran Quotas vous permet de fixer des limites de dépense et de jetons par tenant, projet, agent, utilisateur, modèle ou fournisseur, et de suivre la part de chaque limite déjà consommée. Chemin dans le portail : /finops/quotas (menu FinOps > Quotas). Les analystes FinOps et les administrateurs de tenant gèrent les quotas ; les auditeurs les lisent.

Ce que montre l'écran

Zone	Contenu
Consommation actuelle	Une jauge par quota : nom, consommé / limite, unité (devise d'un quota de coût, ou jetons) et pourcentage. La barre passe à l'orange dès 80 % et au rouge à 100 %. Paginée. Aucune consommation de quota quand rien n'a été consommé.
Tableau Quotas	Colonnes : Nom, Type de portée, Valeur de portée, Plafond de coût, Plafond de jetons, Période, Application (`hard` ou `soft`), Activé.
État vide	Aucun quota : limitez dépense ou jetons par tenant, projet ou agent.

Un quota hard (Strict) refuse l'appel qui le dépasserait (erreur quota_exceeded, HTTP 429) ; un quota soft (Souple) le laisse passer. Chaque quota lève des alertes quota quand sa consommation franchit les seuils (50, 80 et 100 % par défaut, réglage EAI_FINOPS_ALERT_THRESHOLDS).

Actions

Bouton ou action	Ce qu'il fait	Appel API	Rôles
Nouveau quota	Ouvre le formulaire : Nom (obligatoire), Type de portée (obligatoire : `tenant`, `project`, `agent`, `user`, `model`, `provider`), Valeur de portée, Période (obligatoire : `month`, `day`, `run`), Plafond de coût (par exemple `500.00`), Plafond de jetons, Devise (par défaut `EUR`), Application (obligatoire : `hard`, `soft`), Activé. Créer l'envoie.	`POST /v1/quotas`	`finops`, `tenant_admin`, `platform_admin`
Modifier (menu de la ligne)	Ouvre le même formulaire rempli avec le quota et l'enregistre.	`PUT /v1/quotas/{quota_id}`	`finops`, `tenant_admin`, `platform_admin`
Supprimer (menu de la ligne)	Ouvre Confirmer une action destructive : ressources impactées, risques, permissions ; vous saisissez le nom de la ressource, puis Confirmer.	`DELETE /v1/quotas/{quota_id}` (impact lu avec `GET /v1/lineage/graph`)	`finops`, `tenant_admin`, `platform_admin`
Actualiser (icône flèche ronde)	Recharge la liste des quotas.	`GET /v1/quotas`	Lecteurs de la section FinOps
Jauges	Chargées avec l'écran.	`GET /v1/quotas/usage`	Lecteurs de la section FinOps

Rôles

Rôle	Accès
`finops`, `tenant_admin`	Créent, modifient et suppriment les quotas (`ADMIN_ROLES` de `services/control-plane/src/eai/domains/finops/__init__.py`).
`platform_admin`	Mêmes droits, dans un tenant (sinon `tenant_required`).
`auditor`	Lit les quotas et les jauges ; les boutons sont masqués.
`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

Plafonner la dépense mensuelle d'un projet

Ouvrir le formulaire. Cliquez sur Nouveau quota. Résultat attendu : le formulaire s'ouvre à droite. En cas d'échec : si le bouton est absent, demandez le rôle finops.
Décrire la portée. Choisissez project dans Type de portée et saisissez l'identifiant du projet dans Valeur de portée, pour que la limite ne s'applique qu'à ce projet. Résultat attendu : les champs sont remplis. En cas d'échec : le serveur refuse une Valeur de portée avec le type tenant, et une valeur vide avec tout autre type.
Fixer la limite. Choisissez month dans Période, saisissez le Plafond de coût, choisissez hard dans Application pour bloquer les appels au-delà, puis cliquez sur Créer. Résultat attendu : le message Créé apparaît et le quota est listé. En cas d'échec : validation_error avec limit signifie que ni Plafond de coût ni Plafond de jetons n'est renseigné.
Vérifier la jauge. La jauge apparaît dans Consommation actuelle dès que le projet consomme. Résultat attendu : la jauge affiche consommé / limite et le pourcentage. En cas d'échec : cliquez sur Actualiser ou rechargez la page.

Assouplir un quota temporairement

Modifier le quota. Ouvrez le menu de la ligne et choisissez Modifier. Résultat attendu : le formulaire s'ouvre avec les valeurs actuelles. En cas d'échec : quota_not_found signifie que le quota a été supprimé entre-temps.
Passer en souple. Choisissez soft dans Application et cliquez sur Modifier. Un quota souple laisse passer les appels mais lève toujours les alertes quota. Résultat attendu : le message Terminé apparaît et la colonne Application affiche soft. En cas d'échec : lisez l'encadré d'erreur du formulaire.

Dépannage

Symptôme	Cause	Correction
Erreur `validation_error` (HTTP 422) avec `limit`	Ni Plafond de coût ni Plafond de jetons n'est rempli.	Remplissez au moins une limite.
Erreur `validation_error` (HTTP 422) avec `scope_value`	Valeur de portée renseignée avec `tenant`, ou absente avec un autre type de portée.	Videz-la pour `tenant`, remplissez-la pour les autres types.
Erreur `quota_not_found` (HTTP 404) : « Quota introuvable. »	Le quota n'existe plus.	Cliquez sur Actualiser.
Appels refusés avec `quota_exceeded` (HTTP 429) : « Quota dépassé : ... »	Un quota `hard` est atteint sur sa période.	Relevez la limite, passez en `soft`, ou attendez la période suivante.
Confirmer reste désactivé dans la boîte de suppression	Le nom saisi ne correspond pas à la ressource.	Saisissez le nom exact affiché dans la boîte.

Ce que montre l'écran​

Actions​

Rôles​

Tâches courantes​

Plafonner la dépense mensuelle d'un projet​

Assouplir un quota temporairement​

Dépannage​

Pages liées​