Esempi di casi d’uso
Reparti con amministratori delegati
Acme Corp ha 10 reparti. Ogni responsabile di reparto gestisce i limiti delle proprie organizzazioni, mentre l’IT centrale stabilisce il totale di ciascun reparto. Questo esempio ne mostra due. Alice, l’amministratrice aziendale, crea un budget per ogni reparto sotto il budget Account e lo condivide con il rispettivo amministratore di reparto. Ogni amministratore di reparto crea poi un budget per ciascuna delle proprie organizzazioni.Budget di reparto sotto il budget Account
- Bob, l’amministratore del reparto Engineering, può impostare limiti e limiti temporanei su qualsiasi budget sotto Engineering. Ad esempio, può assegnare a Payments un limite temporaneo di 6,000 ACU per una settimana particolarmente intensa.
- Bob non può aumentare il limite di 30,000 ACU di Engineering: può farlo solo Alice.
- L’utilizzo di ogni org di Engineering viene conteggiato nel limite di 30,000 ACU, anche se la somma dei budget delle org è superiore.

La pagina Budget vista da un amministratore di reparto, con il budget Account bloccato

Un amministratore di reparto aumenta il limite di un budget figlio

Un amministratore di reparto non può modificare il limite del budget del proprio reparto
Un budget di progetto con limiti per utente più alti
Ogni sviluppatore dispone di 200 ACU al mese. Per l’iniziativa di migrazione, Acme Corp riserva 5,000 ACU e consente a chi lavora al progetto di usarne di più. Mantieni le organizzazioni Developer tools in un budget Developer tools con un livello predefinito di 200 ACU. Crea un budget Migration initiative con un limite di 5,000 ACU. Inserisci al suo interno l’org del progetto e assegna al budget un livello predefinito di 1,000 ACU. Entrambi i budget si trovano sotto l’Account budget.Budget Developer tools e Migration initiative con i rispettivi livelli
- Carol, una sviluppatrice che lavora al progetto, può usare fino a 1,000 ACU nell’org Migration e fino a 200 ACU nelle organizzazioni Developer tools.
- L’intero progetto non può mai superare i 5,000 ACU al mese.

Selettore dei budget in My Analytics con più budget
Come funzionano i budget
Albero dei budget
Ogni account Enterprise ha un unico albero dei budget. La radice è l’Account budget, sotto cui si trovano i budget figli. Un albero può avere al massimo tre livelli di profondità. Un budget può contenere una o più organizzazioni. Ogni organizzazione appartiene a un solo budget. Le nuove organizzazioni vengono inserite sotto l’Account budget. Ad esempio, Acme Corp imposta un limite di 100,000 ACU sul proprio Account budget. Il reparto Engineering suddivide il proprio pool in tre budget figli.Albero dei budget con budget e tier di limiti per utente

Albero dei budget con l'utilizzo di ciascun budget (dati fittizi)
Limiti dei budget
Il limite di un budget fissa un tetto all’utilizzo di ACU complessivo delle org del budget e delle org dei suoi budget figli, per una finestra mensile. Un limitenull indica che non c’è alcun limite.
- L’utilizzo viene conteggiato per ogni antenato. L’utilizzo in un budget figlio viene conteggiato anche per il budget padre e per il budget dell’Account.
- Un antenato esaurito blocca i suoi figli. Quando un qualsiasi budget lungo il percorso si esaurisce, l’utilizzo in quel ramo si interrompe.
- La somma dei limiti dei figli può superare il limite del padre. Il limite del padre resta comunque il tetto del loro utilizzo complessivo.
- Un budget senza limite è comunque vincolato dai budget padre.
Cosa succede quando un budget si esaurisce
Quando un budget si esaurisce, l’utilizzo viene bloccato per le organizzazioni associate. L’utilizzo si blocca anche quando si esaurisce uno qualsiasi dei budget padre. L’utilizzo riprende con la finestra mensile successiva, oppure quando un amministratore aumenta il limite o imposta un limite temporaneo.- Sessioni Devin: non è possibile avviare nuove sessioni e quelle in esecuzione entrano in sospensione. Gli utenti visualizzano il messaggio “Increase your organization’s usage limit.”
- Devin CLI e Local Agent di Desktop: le richieste vengono bloccate. Gli utenti visualizzano il messaggio “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: le nuove revisioni vengono bloccate.

Banner del compositore quando il budget è esaurito
Finestra mensile
I limiti di budget, i limiti per utente e i limiti temporanei vengono reimpostati all’inizio di ogni finestra mensile. Ogni finestra inizia nel giorno di avvio della tua fase di fatturazione, che non sempre coincide con il mese di calendario. Ad esempio, se la fase di fatturazione inizia il 15, le finestre vanno dal 15 ottobre al 14 novembre, poi dal 15 novembre al 14 dicembre. Un limite temporaneo sostituisce il limite del budget per il resto della finestra attuale. Il limite permanente torna in vigore nella finestra successiva. Un limite personalizzato per utente temporaneo scade alla fine della finestra attuale.
Un limite temporaneo porta il budget di Marketing a 6,000 ACU solo per questa finestra
Limiti utente in un budget
I limiti utente stabiliscono quanto può consumare una singola persona in una finestra mensile. Ogni budget con un’organizzazione collegata ha i propri limiti utente, che si applicano solo all’interno di quel budget.- Livelli. Ogni budget ha i propri livelli e un livello predefinito. Un livello imposta il limite mensile di ACU per i suoi membri.
- Mappature dei gruppi IdP. Mappa un gruppo del provider di identità a un livello. I membri del gruppo ottengono quel livello.
- Eccezioni. Imposta un limite permanente o temporaneo per un singolo utente.
- Policy di richiesta. Ogni livello stabilisce come vengono gestite le richieste di aumento del limite.
unconditionaleconditionalapprovano le richieste fino almax_limitdel livello.manualinoltra le richieste a un amministratore per la revisione. - Ambito. Un limite utente conteggia solo l’utilizzo dell’utente nelle organizzazioni di quel budget.
- Copia e cancella. Copia i livelli da un altro budget o dall’account. Puoi anche copiare le mappature dei gruppi IdP, le assegnazioni e le eccezioni. Cancella tutti i livelli di un budget per ricominciare da zero.

Finestra di dialogo Copia policy di utilizzo con Developer tools come sorgente
Chi può gestire un budget
Gli amministratori Enterprise gestiscono i budget in Enterprise Settings, nella sezione Budgets. Gestiscono l’intera gerarchia, compreso l’Account budget.- Delega. Un amministratore Enterprise può condividere un budget con una persona o un gruppo dalla scheda Manage access. Un amministratore delegato può creare budget al suo interno e impostare limiti e limiti temporanei su questi budget figli. La delega va abilitata separatamente: contatta il tuo team di gestione dell’account.
- Un amministratore delegato non può aumentare il limite del budget che gli è stato condiviso. Solo un amministratore che gestisce il budget padre può modificarlo.
- I membri possono visualizzare il proprio utilizzo e il proprio limite in My Analytics.

Scheda Manage access del budget Engineering, con Bob come gestore
Domande frequenti
Gli amministratori dell'organizzazione possono impostare il limite di ACU di un'org?
Gli amministratori dell'organizzazione possono impostare il limite di ACU di un'org?
Perché l'endpoint del limite dell'org restituisce 409?
Perché l'endpoint del limite dell'org restituisce 409?
409 se l’org condivide il proprio budget con altre org oppure se si trova direttamente nel budget Account. Il messaggio di errore è “This organization has no limit of its own. Set the limit on its budget.” Ad esempio, se Globex, Initech e Umbrella condividono un unico budget, una richiesta di scrittura del limite per Globex restituisce 409.Quando vengono reimpostati i limiti?
Quando vengono reimpostati i limiti?
Un'org può appartenere a due budget?
Un'org può appartenere a due budget?
Gestire i budget con la V3 API
Tutte le richieste si autenticano con un token utente di servizio aziendale. Il chiamante deve disporre dell’autorizzazione di account ManageAcuLimits oppure di un accesso delegato al budget. Usahttps://api.devin.ai come URL di base. Consulta la panoramica della V3 API per indicazioni su autenticazione e utenti di servizio.
Gli endpoint di collezione specifici del budget ricevono il budget nel percorso: /v3beta1/enterprise/usage-policies/budgets/{budget_id}/.... Gli endpoint che fanno riferimento a un singolo tier o a una singola richiesta (/tiers/{tier_id}, /requests/{request_id}) ricavano il budget dal tier o dalla richiesta, quindi condividono i percorsi con gli endpoint a livello di account.
Semantica di PATCH
Per gli endpointPATCH:
- Un campo omesso rimane invariato.
- Un campo impostato su
nullviene cancellato. - Un campo impostato su un valore viene creato o aggiornato.
Endpoint dei budget
Elencare i budget
budget_id: l’identificatore da usare nei percorsi relativi a un budget.parent_budget_id: il budget padre;nullper il budget root dell’account.org_ids: le organizzazioni collegate a questo budget, il cui utilizzo viene conteggiato su di esso. Vuoto se non è collegata alcuna organizzazione.status:activeoarchived.cycle_acu_limit: il limite del budget sul consumo di ACU addebitato al budget stesso e ai suoi discendenti in ogni finestra mensile di fatturazione;nullindica nessun limite.temporary_cycle_acu_limit: un limite che sostituiscecycle_acu_limitfino alla fine del periodo di fatturazione mensile corrente;nullse non ce n’è nessuno attivo.
Aggiorna un budget
null rimuove un limite. È obbligatorio specificare almeno un campo.
parent_budget_id: sposta il budget, insieme ai suoi sotto-budget, sotto un altro budget attivo. Il budget root non può essere spostato e i budget possono essere annidati al massimo su tre livelli.cycle_acu_limit,temporary_cycle_acu_limit: i limiti del budget, come nella risposta dell’endpoint di elenco.
temporary_cycle_acu_limit, il limite viene riavviato per la finestra attuale. Per un budget collegato a una sola organizzazione, cycle_acu_limit diventa anche il limite di ACU dell’organizzazione.
Endpoint dei tier
Elencare i livelli
priority più alta e, a parità di priorità, prima i più recenti. Ogni tier ha questo formato:
is_default: indica se questo è il tier predefinito del budget.cycle_acu_limit: il limite di ACU predefinito per ciclo per ciascun membro;nullindica che non è previsto un limite massimo.policy: indica come vengono gestite le richieste di aumento del limite relative al tier:unconditionaleconditionalle approvano fino amax_limit, mentremanualrichiede la revisione di un amministratore.max_limit: il limite massimo fino al quale vengono approvate le richieste di aumento; connullle richieste vengono approvate senza alcun tetto. È semprenullquandocycle_acu_limitènull.priority: determina la posizione del tier tra i livelli associati ai gruppi dell’IdP di un utente: prevale il valore più alto e, in caso di parità, il tier creato più di recente. Un’assegnazione esplicita dell’utente ha la precedenza su questo ordinamento, mentre il tier predefinito non rientra mai nell’ordinamento.member_count: il numero di utenti attualmente assegnati al tier. Per il tier predefinito, include tutti i membri del budget che non appartengono a un altro tier.
Crea un tier
201 con il tier creato.
Recuperare un tier
Aggiorna un tier
Elimina un tier
204 in caso di esito positivo. Il livello predefinito non può essere eliminato (prima è necessario promuovere un altro tier a predefinito). Prima di eliminare un tier, occorre spostarne gli eventuali utenti e rimuovere tutte le mappature dei gruppi IdP associate.
Endpoint per gli utenti del tier
Elencare gli utenti di un tier
cycle_acu_limit_override: la deroga permanente dell’utente, se presente.temporary_cycle_acu_limit: la sostituzione temporanea dell’utente, presente solo finché è attiva nel periodo di fatturazione mensile corrente.effective_cycle_acu_limit: il limite attualmente imposto all’utente;nullindica che è senza limite massimo.limit_source: l’origine del limite effettivo:override(permanente),temporary_overrideotier.membership: il motivo per cui l’utente appartiene al tier:explicit(assegnato direttamente),idp_group(tramite la mappatura dei gruppi IdP che ha la precedenza) odefault(fallback al livello predefinito).
Assegnare un utente a un tier
204 in caso di esito positivo. Se un utente viene spostato da un altro tier, qualsiasi limite personalizzato per singolo utente viene cancellato: l’utente erediterà quindi inizialmente il limite del tier di destinazione.
Rimuovere un utente da un tier
204.
Endpoint utente
Ottenere i limiti di un utente
tier_id/tier_name: il tier da cui deriva il limite dell’utente (assegnazione esplicita, mappatura dei gruppi IdP o tier predefinito);nullse il budget non prevede livelli.tier_cycle_acu_limit: il limite del tier stesso, prima di qualsiasi override;nullindica che è senza limite massimo.pending_request_id/pending_request_cycle_acu_limit: l’eventuale richiesta di aumento del limite in sospeso dell’utente e il limite richiesto.
Imposta o cancella l’override di un utente
kind è obbligatorio quando si imposta un valore: permanent non scade mai; temporary scade alla fine del periodo di fatturazione mensile corrente.
Corpo della richiesta — cancellare tutte le eccezioni
204 in caso di esito positivo.
Endpoint dei gruppi IdP
Mappa un gruppo IdP a un tier affinché i suoi membri ereditino automaticamente quel tier. Le mappature vengono determinate in tempo reale in base all’appartenenza ai gruppi e non modificano mai l’assegnazione esplicita del tier di un utente: un’assegnazione esplicita ha sempre la precedenza. A un utente che appartiene a più gruppi mappati viene applicato il tier associato con la priorità più alta (ovvero quello con il valorepriority più alto; a parità di valore prevale il tier più recente).
Elenco delle mappature dei gruppi IdP
?tier_id= per elencare solo i gruppi mappati a un determinato tier:
Ottenere la mappatura di un gruppo IdP
404 se il gruppo non ha alcuna mappatura nel budget.
Mappa un gruppo IdP a un tier
Rimuovere la mappatura di un gruppo IdP
204 in caso di esito positivo. Il tier associato non viene più applicato ai membri del gruppo; agli utenti senza un’assegnazione esplicita e senza un altro tier associato si applica il tier predefinito.
Endpoint per le richieste di aumento del limite
Gli utenti possono richiedere un limite per ciclo più elevato. L’esito dipende dallapolicy del tier del richiedente: con unconditional e conditional la richiesta viene approvata automaticamente fino al max_limit del tier, mentre con manual resta in sospeso finché un amministratore non la esamina tramite questi endpoint.
Elencare le richieste di aumento del limite
?status= (pending, approved, denied, expired) e ?user_id=:
tier_id/tier_name: il tier del richiedente all’interno del budget;nullse il budget non prevede livelli.current_cycle_acu_limit: il limite attualmente imposto al richiedente;nullindica un utilizzo senza limite massimo.status:expiredindica che la richiesta era ancora in attesa al termine del relativo ciclo di fatturazione.reviewer: l’amministratore che ha esaminato la richiesta;nullfinché la richiesta è in attesa.
Recuperare una richiesta di aumento del limite
Approvare una richiesta di aumento del limite
409 se la richiesta è già stata esaminata o se il richiedente non è più un membro dell’account.
Rifiutare una richiesta di aumento del limite
409 se è già stata esaminata.

