Passer au contenu principal
Les budgets vous permettent de plafonner l’utilisation des ACU selon l’organisation de votre entreprise : une limite pour le compte, des réserves partagées pour les équipes ou les projets, et des limites par utilisateur au sein de chaque réserve.

Exemples de cas d’utilisation

Départements avec administrateurs délégués

Acme Corp compte 10 départements. Chaque responsable de département gère les limites de ses organisations, tandis que le service informatique central fixe le total alloué à chaque département. Cet exemple en présente deux. Alice, l’administratrice d’entreprise, crée un budget pour chaque département sous le budget du compte, puis partage chacun d’eux avec l’administrateur du département concerné. Chaque administrateur de département crée ensuite un budget pour chacune de ses organisations.
Budget du compte de 100,000 ACU, avec Engineering à 30,000 ACU, qui comprend Payments et Search, et Marketing à 5,000 ACU.

Budgets des départements sous le budget du compte

  • Bob, l’administrateur du département Engineering, peut définir des limites, y compris temporaires, sur n’importe quel budget rattaché à Engineering. Par exemple, il peut accorder à Payments une limite temporaire de 6,000 ACU pour une semaine chargée.
  • Bob ne peut pas relever la limite de 30,000 ACU d’Engineering : seule Alice en a la possibilité.
  • L’utilisation de toutes les organisations d’Engineering est imputée sur la limite de 30,000 ACU, même si la somme des budgets des organisations la dépasse.
Page Budgets vue par un administrateur de département

La page Budgets vue par un administrateur de département, avec le budget du compte verrouillé

Relèvement de la limite d’un budget enfant

Un administrateur de département relève la limite d’un budget enfant

La limite du budget du département est en lecture seule

Un administrateur de département ne peut pas modifier la limite du budget de son département

Un budget de projet avec des limites par utilisateur plus élevées

Chaque développeur dispose de 200 ACU par mois. Pour l’initiative de migration, Acme Corp réserve 5,000 ACU et autorise les membres du projet à en consommer davantage. Conservez les organisations Developer tools dans un budget Developer tools avec un niveau par défaut de 200 ACU. Créez un budget Migration initiative avec une limite de 5,000 ACU. Placez-y l’organisation du projet et attribuez-lui un niveau par défaut de 1,000 ACU. Les deux budgets dépendent du budget du compte.
Developer tools à 20,000 ACU avec un niveau par défaut de 200 ACU, et Migration initiative à 5,000 ACU avec un niveau par défaut de 1,000 ACU.

Budgets Developer tools et Migration initiative avec leurs niveaux

  • Carol, développeuse affectée au projet, peut utiliser jusqu’à 1,000 ACU dans l’organisation Migration, et jusqu’à 200 ACU dans les organisations Developer tools.
  • L’ensemble du projet ne peut en aucun cas dépasser 5,000 ACU par mois.
Sélecteur de budget de Mes analyses

Sélecteur de budget de Mes analyses avec plusieurs budgets

Fonctionnement des budgets

Arborescence des budgets

Chaque compte Enterprise dispose d’une seule arborescence de budgets. Sa racine est le budget du compte, sous lequel se trouvent les budgets enfants. Une arborescence peut compter jusqu’à trois niveaux de profondeur. Un budget peut contenir une ou plusieurs organisations. Chaque organisation appartient à un seul et unique budget. Les nouvelles organisations sont placées sous le budget du compte. Par exemple, Acme Corp fixe une limite de 100,000 ACU pour son budget du compte. Engineering répartit son pool entre trois budgets enfants.
Budget du compte de 100,000 ACU, avec Engineering à 40,000 ACU et ses trois budgets enfants, et Developer tools à 20,000 ACU avec trois niveaux de limite par utilisateur.

Arborescence des budgets avec budgets et niveaux de limite par utilisateur

Les niveaux sont des limites par utilisateur au sein d’un même budget, et non des budgets distincts.
Arborescence des budgets avec l’utilisation de chaque budget

Arborescence des budgets avec l’utilisation de chaque budget (données fictives)

Limites de budget

Une limite de budget plafonne l’utilisation cumulée des ACU par les organisations du budget et celles de ses budgets enfants, sur une période mensuelle. Une limite null signifie qu’il n’y a aucune limite.
  • L’utilisation est imputée à chaque ancêtre. L’utilisation dans un budget enfant est également imputée à son parent et au budget du compte.
  • Un ancêtre épuisé bloque ses enfants. Dès qu’un budget du chemin est épuisé, l’utilisation s’arrête dans toute cette branche.
  • La somme des limites des enfants peut dépasser la limite du parent. La limite du parent continue de plafonner leur utilisation cumulée.
  • Un budget sans limite reste plafonné par ses parents.
Un budget lié à une seule organisation partage sa limite avec cette organisation. Les points de terminaison de limite d’ACU au niveau de l’organisation, désormais obsolètes, permettent également de la définir. Vous pouvez aussi utiliser le point de terminaison de mise à jour ci-dessous.

Ce qui se passe lorsqu’un budget est épuisé

Lorsqu’un budget est épuisé, l’utilisation est interrompue pour ses organisations. Elle l’est également dès qu’un budget parent est épuisé. L’utilisation reprend à la période mensuelle suivante, ou dès qu’un administrateur relève la limite ou définit une limite temporaire.
  • Sessions Devin : il n’est plus possible de démarrer de nouvelles sessions, et les sessions en cours passent en veille. Les utilisateurs voient le message « Increase your organization’s usage limit. »
  • Devin CLI et agent local de l’application de bureau : les requêtes sont bloquées. Les utilisateurs voient le message « Your organization has reached its monthly usage limit. Ask an account admin to raise it, or wait for the limit to reset next month. »
  • Devin Review : les nouvelles revues sont bloquées.
Bannière du composer : limite d'utilisation atteinte

Bannière du composer lorsque le budget est épuisé

Période mensuelle

Les limites de budget, les limites utilisateur et les limites temporaires sont réinitialisées au début de chaque période mensuelle. Chaque période commence le jour de début de votre phase de facturation et ne correspond donc pas toujours au mois calendaire. Par exemple, si la phase de facturation commence le 15, les périodes vont du 15 octobre au 14 novembre, puis du 15 novembre au 14 décembre. Une limite temporaire remplace la limite du budget pour le reste de la période actuelle. La limite permanente s’applique de nouveau dès la période suivante. Une dérogation utilisateur temporaire expire à la fin de la période actuelle.
Budget Marketing avec une limite temporaire

Une limite temporaire porte le budget Marketing à 6,000 ACU pour cette période uniquement

Limites utilisateur dans un budget

Les limites utilisateur plafonnent la consommation d’une personne sur une période mensuelle. Chaque budget lié à une organisation dispose de ses propres limites utilisateur, qui s’appliquent uniquement au sein de ce budget.
  • Niveaux. Chaque budget possède ses propres niveaux, dont un niveau par défaut. Un niveau définit la limite mensuelle d’ACU applicable à ses membres.
  • Mappages de groupe IdP. Mappez un groupe du fournisseur d’identité à un niveau. Les membres du groupe se voient attribuer ce niveau.
  • Dérogations. Définissez une limite permanente ou temporaire pour un utilisateur donné.
  • Politiques de demande. Chaque niveau détermine le traitement des demandes d’augmentation de limite. unconditional et conditional approuvent les demandes jusqu’à la valeur max_limit du niveau. manual transmet les demandes à un administrateur pour revue.
  • Périmètre. Une limite utilisateur ne prend en compte que l’utilisation de l’utilisateur dans les organisations de ce budget.
  • Copie et effacement. Copiez les niveaux d’un autre budget ou du compte. Vous pouvez également copier les mappages de groupe IdP, les attributions et les dérogations. Effacez tous les niveaux d’un budget pour repartir de zéro.
Une limite utilisateur définie sur un budget parent ne s’applique pas à ses budgets enfants. Par exemple, si Engineering contient également une organisation, une limite utilisateur de 300 ACU sur Engineering ne plafonne pas l’utilisation d’un utilisateur dans Payments ou Search.
Boîte de dialogue de copie des politiques d’utilisation

Boîte de dialogue de copie des politiques d’utilisation, avec Developer tools comme source

Qui peut gérer un budget

Les Enterprise Admin gèrent les budgets dans Enterprise Settings, sous Budgets. Ils gèrent l’ensemble de l’arborescence, y compris le budget du compte.
  • Délégation. Un administrateur d’entreprise peut partager un budget avec une personne ou un groupe depuis l’onglet Manage access. Un administrateur délégué peut alors créer des budgets enfants sous ce budget, et définir des limites et des limites temporaires pour ces budgets enfants. La délégation doit être activée séparément ; contactez votre équipe chargée du compte.
  • Un administrateur délégué ne peut pas augmenter la limite du budget partagé lui-même. Seul un administrateur qui gère le budget parent peut la modifier.
  • Les Membres consultent leur propre utilisation et leur limite dans Mes analyses.
Onglet Manage access du budget Engineering

Onglet Manage access du budget Engineering, avec Bob comme gestionnaire

Questions fréquentes

Non. Ce sont les Enterprise Admin qui définissent les limites d’ACU des organisations. Pour permettre à une équipe de gérer ses propres limites, partagez un budget avec l’administrateur de cette équipe.
Une fois les limites de budget imposées pour votre entreprise, l’endpoint de limite d’organisation renvoie le code HTTP 409 lorsque l’organisation partage son budget avec d’autres organisations ou lorsqu’elle est rattachée directement au budget du compte. Le message d’erreur est le suivant : « This organization has no limit of its own. Set the limit on its budget. » Par exemple, si Globex, Initech et Umbrella partagent un même budget, toute tentative de définir une limite pour Globex renvoie 409.
Au début de chaque période mensuelle. Celle-ci commence le jour de début de votre phase de facturation.
Non. Chaque organisation appartient à un seul et unique budget. Un budget peut en revanche contenir plusieurs organisations.

Gérer les budgets avec l’API V3

Toutes les requêtes s’authentifient au moyen d’un jeton d’utilisateur de service Enterprise. Les appelants doivent disposer de l’autorisation de compte ManageAcuLimits ou d’un accès délégué au budget. Utilisez https://api.devin.ai comme URL de base. Consultez la vue d’ensemble de l’API V3 pour en savoir plus sur l’authentification et pour obtenir des consignes sur les utilisateurs de service. Les points de terminaison de collection budget-scoped indiquent le budget dans le chemin : /v3beta1/enterprise/usage-policies/budgets/{budget_id}/.... Les points de terminaison qui ciblent un niveau ou une demande spécifique (/tiers/{tier_id}, /requests/{request_id}) déduisent le budget du niveau ou de la demande ; ils partagent donc leurs chemins avec les points de terminaison à l’échelle du compte.

Sémantique de PATCH

Pour les points de terminaison PATCH :
  • Un champ omis reste inchangé.
  • Un champ défini sur null est effacé.
  • Un champ auquel une valeur est attribuée est créé ou mis à jour.

Points de terminaison des budgets

Lister les budgets

Renvoie une liste paginée des budgets du compte, actifs et archivés. Chaque budget se présente comme suit :
  • budget_id : l’identifiant à utiliser dans les chemins budget-scoped.
  • parent_budget_id : le budget parent ; null pour le budget racine du compte.
  • org_ids : les organisations liées à ce budget. Leur utilisation est imputée à ce budget. Vide si aucune organisation n’est liée.
  • status : active ou archived.
  • cycle_acu_limit : la limite de consommation d’ACU imputée au budget et à ses descendants pour chaque période de facturation mensuelle ; null signifie qu’il n’y a aucune limite.
  • temporary_cycle_acu_limit : une limite qui remplace cycle_acu_limit jusqu’à la fin de la période de facturation mensuelle en cours ; null si aucune limite temporaire n’est en vigueur.

Mettre à jour un budget

Mise à jour partielle : les champs omis restent inchangés et null efface une limite. Au moins un champ est obligatoire.
  • parent_budget_id : déplace le budget, ainsi que ses sous-budgets, sous un autre budget actif. Le budget racine ne peut pas être déplacé, et les budgets peuvent être imbriqués sur trois niveaux au maximum.
  • cycle_acu_limit, temporary_cycle_acu_limit : les limites du budget, telles qu’elles figurent dans la réponse de la liste.
Corps de la requête — définir la limite et une augmentation temporaire pour ce mois-ci
Corps de la requête — supprimer les limites
Corps de la requête — déplacer le budget sous un autre budget
Renvoie le budget mis à jour. Redéfinir temporary_cycle_acu_limit le relance pour la fenêtre actuelle. Pour un budget lié à exactement une organisation, cycle_acu_limit devient également la limite d’ACU de l’organisation.

Points de terminaison de niveau

Lister les niveaux

Renvoie une liste paginée des niveaux du budget, triés par ordre de priorité : priority la plus élevée en premier, puis, à priorité égale, du niveau le plus récent au plus ancien. Chaque niveau se présente comme suit :
  • is_default : indique s’il s’agit du niveau par défaut du budget.
  • cycle_acu_limit : limite d’ACU par défaut par cycle pour chaque membre ; null signifie non plafonné.
  • policy : mode de traitement des demandes d’augmentation de limite portant sur ce niveau — unconditional et conditional les approuvent jusqu’à max_limit, tandis que manual exige une revue par un administrateur.
  • max_limit : limite maximale jusqu’à laquelle les demandes d’augmentation sont approuvées ; avec null, elles sont approuvées sans plafond. Toujours null lorsque cycle_acu_limit vaut null.
  • priority : rang du niveau parmi les niveaux mappés au groupe IdP d’un utilisateur — la valeur la plus élevée l’emporte ; en cas d’égalité, le niveau le plus récent prévaut. Une attribution explicite à un utilisateur prime sur ce classement, et le niveau par défaut n’est jamais classé.
  • member_count : nombre d’utilisateurs actuellement rattachés au niveau. Pour le niveau par défaut, ce nombre comprend tous les membres du budget qui n’appartiennent à aucun autre niveau.

Créer un niveau

Corps de la requête
Le premier niveau du budget devient automatiquement son niveau par défaut. Renvoie un code HTTP 201 avec le niveau créé.

Récupérer un niveau

Mettre à jour un niveau

Mise à jour partielle ; les champs omis restent inchangés.

Supprimer un niveau

Renvoie HTTP 204 en cas de réussite. Le niveau par défaut ne peut pas être supprimé (promouvez d’abord un autre niveau). Avant de supprimer un niveau, vous devez déplacer les utilisateurs qui y sont encore rattachés et supprimer toute mise en correspondance de groupe IdP vers ce niveau.

Points de terminaison des utilisateurs de niveau

Lister les utilisateurs d’un niveau

Renvoie une liste paginée des utilisateurs du niveau, avec leurs limites déterminées. Pour le niveau par défaut, il s’agit de tous les membres du budget qui n’appartiennent à aucun autre niveau :
  • cycle_acu_limit_override : la dérogation permanente de l’utilisateur, le cas échéant.
  • temporary_cycle_acu_limit : la dérogation temporaire de l’utilisateur, présente uniquement tant qu’elle est en vigueur dans la période de facturation mensuelle en cours.
  • effective_cycle_acu_limit : la limite actuellement imposée à l’utilisateur ; null signifie qu’il n’est pas plafonné.
  • limit_source : l’origine de la limite effective — override (permanente), temporary_override ou tier.
  • membership : la raison pour laquelle l’utilisateur appartient au niveau — explicit (assigné directement), idp_group (via sa mise en correspondance de groupe IdP prioritaire) ou default (repli sur le niveau par défaut).

Attribuer un niveau à un utilisateur

Idempotent. Renvoie le code HTTP 204 en cas de réussite. Déplacer un utilisateur depuis un autre niveau efface toute dérogation par utilisateur : il hérite donc initialement de la limite du niveau de destination.

Retirer un utilisateur d’un niveau

Supprime l’attribution explicite de niveau de l’utilisateur (ainsi que toute dérogation). L’utilisateur se voit alors appliquer son niveau mappé au groupe IdP, le cas échéant, ou à défaut le niveau par défaut. Renvoie le code HTTP 204 en cas de réussite.

Points de terminaison utilisateur

Obtenir les limites d’un utilisateur

Renvoie le niveau déterminé de l’utilisateur, ses limites et sa requête en attente au sein du budget. Inclut les champs utilisateur du niveau décrits ci-dessus, ainsi que :
  • tier_id / tier_name : le niveau dont découle la limite de l’utilisateur (attribution explicite, mise en correspondance de groupe IdP ou niveau par défaut) ; null lorsque le budget ne comporte aucun niveau.
  • tier_cycle_acu_limit : la limite propre au niveau, avant toute dérogation ; null signifie que la limite n’est pas plafonnée.
  • pending_request_id / pending_request_cycle_acu_limit : la demande d’augmentation de limite en attente de l’utilisateur et la limite qu’elle demande, le cas échéant.

Définir ou effacer la dérogation d’un utilisateur

User-scoped : il suffit que la cible soit membre du budget — aucun niveau n’entre en jeu, et l’attribution de niveau de l’utilisateur n’est jamais modifiée. Corps de la requête — définir une dérogation temporaire
kind est obligatoire pour définir une valeur : permanent n’expire jamais ; temporary expire à la fin de la période de facturation mensuelle en cours. Corps de la requête — effacer toutes les dérogations
L’endpoint renvoie le code HTTP 204 en cas de succès.

Points de terminaison des groupes IdP

Associez un groupe IdP à un niveau afin que ses membres héritent automatiquement de ce niveau. Les mises en correspondance sont déterminées en temps réel à partir de l’appartenance aux groupes et ne modifient jamais l’attribution explicite d’un niveau à un utilisateur : une attribution explicite l’emporte toujours. Lorsqu’un utilisateur appartient à plusieurs groupes mis en correspondance, le niveau retenu est le niveau associé highest-ranked (celui dont la priority est la plus élevée ; en cas d’égalité, le niveau le plus récent l’emporte).

Lister les mises en correspondance de groupes IdP

Renvoie une liste paginée des mises en correspondance groupe-niveau du budget, du plus ancien au plus récent. Filtrez avec ?tier_id= pour ne lister que les groupes mis en correspondance avec un niveau donné :

Obtenir la mise en correspondance d’un groupe IdP

Renvoie le code HTTP 404 si le groupe n’a aucune mise en correspondance dans le budget.

Associer un groupe IdP à un niveau

Corps de la requête
Upsert idempotent. Le niveau doit appartenir au budget. Un groupe ne peut être mappé qu’à un seul niveau par budget : mapper un groupe déjà mappé le déplace donc vers le niveau indiqué.

Supprimer le mappage d’un groupe IdP

Renvoie HTTP 204 en cas de réussite. Le niveau associé ne s’applique plus aux membres du groupe ; les utilisateurs sans attribution explicite ni autre niveau associé se voient appliquer le niveau par défaut.

Points de terminaison des demandes d’augmentation de limite

Les utilisateurs peuvent demander une limite par cycle plus élevée. La policy du niveau du demandeur détermine la suite : avec unconditional et conditional, la demande est approuvée automatiquement jusqu’à la valeur max_limit du niveau, tandis qu’avec manual, elle reste en attente de revue par un administrateur via ces points de terminaison.

Lister les demandes d’augmentation de limite

Renvoie une liste paginée des demandes associées au budget, filtrable avec ?status= (pending, approved, denied, expired) et ?user_id= :
  • tier_id / tier_name : le niveau du demandeur au sein du budget ; null si le budget ne comporte aucun niveau.
  • current_cycle_acu_limit : la limite actuellement imposée au demandeur ; null signifie qu’elle n’est pas plafonnée.
  • status : expired signifie que la requête était toujours en attente à la fin de son cycle de facturation.
  • reviewer : l’administrateur qui a examiné la requête ; null tant que celle-ci est en attente.

Obtenir une demande d’augmentation de limite

Approuver une demande d’augmentation de limite

Accorde la limite demandée sous forme de dérogation temporaire, qui expire à la fin de la période de facturation mensuelle en cours. Vous pouvez facultativement accorder une limite différente :
Renvoie la requête mise à jour. Renvoie le code HTTP 409 si la requête a déjà été examinée ou si le demandeur n’est plus membre du compte.

Refuser une demande d’augmentation de limite

Renvoie la requête mise à jour, ou une erreur HTTP 409 si elle a déjà été examinée.

Exemples de workflows

Configurer les niveaux d’un budget

Recherchez le budget, plafonnez-le à 2 000 ACU par mois, puis créez un niveau par défaut afin que chaque membre du budget bénéficie d’un plafond mensuel de 500 ACU :
Mappez un groupe IdP au niveau et accordez temporairement à un utilisateur une rallonge jusqu’à la fin du mois :