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.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.

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

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

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.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 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.Arborescence des budgets avec budgets et niveaux de limite par utilisateur

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 limitenull 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.
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 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.
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.
unconditionaletconditionalapprouvent les demandes jusqu’à la valeurmax_limitdu niveau.manualtransmet 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.

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, avec Bob comme gestionnaire
Questions fréquentes
Les administrateurs de l’organisation peuvent-ils définir la limite d’ACU d’une organisation ?
Les administrateurs de l’organisation peuvent-ils définir la limite d’ACU d’une organisation ?
Pourquoi l’endpoint de limite d’organisation renvoie-t-il une erreur 409 ?
Pourquoi l’endpoint de limite d’organisation renvoie-t-il une erreur 409 ?
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.Quand les limites sont-elles réinitialisées ?
Quand les limites sont-elles réinitialisées ?
Une organisation peut-elle appartenir à deux budgets ?
Une organisation peut-elle appartenir à deux budgets ?
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. Utilisezhttps://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 terminaisonPATCH :
- Un champ omis reste inchangé.
- Un champ défini sur
nullest effacé. - Un champ auquel une valeur est attribuée est créé ou mis à jour.
Points de terminaison des budgets
Lister les budgets
budget_id: l’identifiant à utiliser dans les chemins budget-scoped.parent_budget_id: le budget parent ;nullpour 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:activeouarchived.cycle_acu_limit: la limite de consommation d’ACU imputée au budget et à ses descendants pour chaque période de facturation mensuelle ;nullsignifie qu’il n’y a aucune limite.temporary_cycle_acu_limit: une limite qui remplacecycle_acu_limitjusqu’à la fin de la période de facturation mensuelle en cours ;nullsi aucune limite temporaire n’est en vigueur.
Mettre à jour un budget
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.
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
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 ;nullsignifie non plafonné.policy: mode de traitement des demandes d’augmentation de limite portant sur ce niveau —unconditionaletconditionalles approuvent jusqu’àmax_limit, tandis quemanualexige une revue par un administrateur.max_limit: limite maximale jusqu’à laquelle les demandes d’augmentation sont approuvées ; avecnull, elles sont approuvées sans plafond. Toujoursnulllorsquecycle_acu_limitvautnull.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
201 avec le niveau créé.
Récupérer un niveau
Mettre à jour un niveau
Supprimer un niveau
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
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 ;nullsignifie qu’il n’est pas plafonné.limit_source: l’origine de la limite effective —override(permanente),temporary_overrideoutier.membership: la raison pour laquelle l’utilisateur appartient au niveau —explicit(assigné directement),idp_group(via sa mise en correspondance de groupe IdP prioritaire) oudefault(repli sur le niveau par défaut).
Attribuer un niveau à un utilisateur
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
204 en cas de réussite.
Points de terminaison utilisateur
Obtenir les limites d’un utilisateur
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) ;nulllorsque le budget ne comporte aucun niveau.tier_cycle_acu_limit: la limite propre au niveau, avant toute dérogation ;nullsignifie 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
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
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 lapriority 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
?tier_id= pour ne lister que les groupes mis en correspondance avec un niveau donné :
Obtenir la mise en correspondance d’un groupe IdP
404 si le groupe n’a aucune mise en correspondance dans le budget.
Associer un groupe IdP à un niveau
Supprimer le mappage d’un groupe IdP
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. Lapolicy 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
?status= (pending, approved, denied, expired) et ?user_id= :
tier_id/tier_name: le niveau du demandeur au sein du budget ;nullsi le budget ne comporte aucun niveau.current_cycle_acu_limit: la limite actuellement imposée au demandeur ;nullsignifie qu’elle n’est pas plafonnée.status:expiredsignifie que la requête était toujours en attente à la fin de son cycle de facturation.reviewer: l’administrateur qui a examiné la requête ;nulltant que celle-ci est en attente.
Obtenir une demande d’augmentation de limite
Approuver une demande d’augmentation de limite
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
409 si elle a déjà été examinée.

