Ejemplos de casos de uso
Departamentos con administradores delegados
Acme Corp tiene 10 departamentos. Cada jefe de departamento gestiona los límites de sus organizaciones, y el departamento central de TI fija el total de cada departamento. Este ejemplo muestra dos de ellos. Alice, la administradora empresarial, crea un presupuesto para cada departamento dentro del presupuesto de la cuenta y lo comparte con el administrador de ese departamento. A su vez, cada administrador de departamento crea un presupuesto para cada una de sus organizaciones.Presupuestos de departamento dentro del presupuesto de la cuenta
- Bob, el administrador del departamento de Engineering, puede establecer límites y límites temporales en cualquier presupuesto que dependa de Engineering. Por ejemplo, puede asignar a Payments un límite temporal de 6,000 ACU durante una semana de mucha actividad.
- Bob no puede aumentar el límite de 30,000 ACU de Engineering. Solo Alice puede hacerlo.
- El consumo de todas las organizaciones de Engineering se descuenta del límite de 30,000 ACU, aunque la suma de los presupuestos de las organizaciones sea mayor.

La página Presupuestos vista por un administrador de departamento, con el presupuesto de la cuenta bloqueado

Un administrador de departamento aumenta el límite de un presupuesto hijo

Un administrador de departamento no puede cambiar el límite del presupuesto de su departamento
Un presupuesto de proyecto con límites por usuario más altos
Cada desarrollador dispone de 200 ACU al mes. Para la iniciativa de migración, Acme Corp reserva 5,000 ACU y permite que las personas del proyecto consuman más. Mantén las organizaciones de Developer tools en un presupuesto Developer tools con un nivel predeterminado de 200 ACU. Crea un presupuesto Migration initiative con un límite de 5,000 ACU. Incluye en él la organización del proyecto y asígnale un nivel predeterminado de 1,000 ACU. Ambos presupuestos dependen del presupuesto de la cuenta.Presupuestos Developer tools y Migration initiative con sus niveles
- Carol, desarrolladora del proyecto, puede usar hasta 1,000 ACU en la organización Migration y hasta 200 ACU en las organizaciones de Developer tools.
- El proyecto en su conjunto nunca puede superar los 5,000 ACU al mes.

Selector de presupuestos de My Analytics con varios presupuestos
Cómo funcionan los presupuestos
Árbol de presupuestos
Cada cuenta de empresa tiene un único árbol de presupuestos. La raíz es el presupuesto de la cuenta (Account budget), del que dependen los presupuestos hijos. Un árbol puede tener hasta tres niveles de profundidad. Un presupuesto puede contener una o varias organizaciones. Cada organización pertenece a un único presupuesto. Las organizaciones nuevas se asignan al presupuesto de la cuenta. Por ejemplo, Acme Corp establece un límite de 100,000 ACU en su presupuesto de la cuenta. Engineering divide su pool en tres presupuestos hijos.Árbol de presupuestos con presupuestos y niveles de límite por usuario

Árbol de presupuestos con el uso de cada presupuesto (datos de ejemplo)
Límites de presupuesto
Un límite de presupuesto restringe el consumo combinado de ACU de las organizaciones del presupuesto y de las organizaciones de sus presupuestos hijos durante un período mensual. Un límitenull significa que no hay límite.
- El consumo se computa en todos los ancestros. El consumo en un presupuesto hijo también se computa en su padre y en el presupuesto de la cuenta.
- Un ancestro agotado bloquea a sus hijos. Cuando cualquier presupuesto de la ruta se agota, el consumo en esa rama se detiene.
- La suma de los límites de los hijos puede superar el límite del padre. Aun así, el límite del padre sigue restringiendo su consumo combinado.
- Un presupuesto sin límite sigue estando restringido por sus padres.
Qué ocurre cuando se agota un presupuesto
Cuando se agota un presupuesto, se detiene el consumo en sus organizaciones. El consumo también se detiene si se agota cualquiera de sus presupuestos padre. El consumo se reanuda en el siguiente período mensual, o cuando un administrador aumenta el límite o establece un límite temporal.- Sesiones de Devin: no se pueden iniciar sesiones nuevas y las sesiones en ejecución pasan a dormir. Los usuarios ven el mensaje “Increase your organization’s usage limit.”
- Devin CLI y agente local de Desktop: las solicitudes se bloquean. Los usuarios ven el mensaje “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: se bloquean las nuevas revisiones.

Banner del editor cuando se agota el presupuesto
Período mensual
Los límites del presupuesto, los límites por usuario y los límites temporales se restablecen al inicio de cada período mensual. Cada período comienza el día de inicio de tu fase de facturación, por lo que no siempre coincide con el mes calendario. Por ejemplo, si la fase de facturación comienza el día 15, los períodos van del 15 de octubre al 14 de noviembre, luego del 15 de noviembre al 14 de diciembre, y así sucesivamente. Un límite temporal sustituye al límite del presupuesto durante el resto del período actual. El límite permanente vuelve a aplicarse en el siguiente período. Una anulación por usuario temporal vence al final del período actual.
Un límite temporal aumenta el presupuesto de Marketing a 6,000 ACU solo durante este período
Límites de usuario en un presupuesto
Los límites de usuario fijan cuánto puede consumir una persona en un período mensual. Cada presupuesto con una organización vinculada tiene sus propios límites de usuario, que se aplican únicamente dentro de ese presupuesto.- Niveles. Cada presupuesto tiene sus propios niveles y un nivel predeterminado. Un nivel establece el límite mensual de ACU para sus miembros.
- Asignaciones de grupos de IdP. Asocia un grupo del proveedor de identidad a un nivel. Los miembros del grupo reciben ese nivel.
- Excepciones. Establece un límite permanente o temporal para un usuario concreto.
- Políticas de solicitud. Cada nivel define cómo se gestionan las solicitudes de aumento del límite.
unconditionalyconditionalaprueban las solicitudes hasta elmax_limitdel nivel.manualenvía las solicitudes a un administrador para que las revise. - Ámbito. Un límite de usuario solo contabiliza el consumo del usuario en las organizaciones de ese presupuesto.
- Copiar y borrar. Copia niveles de otro presupuesto o de la cuenta. También puedes copiar asignaciones de grupos de IdP, asignaciones de usuarios y excepciones. Borra todos los niveles de un presupuesto para empezar de cero.

Diálogo Copiar políticas de uso con Developer tools como origen
Quién puede gestionar un presupuesto
Los Admin de Enterprise gestionan los presupuestos en Enterprise Settings, dentro de Presupuestos. Gestionan todo el árbol, incluido el presupuesto de la cuenta.- Delegación. Un administrador empresarial puede compartir un presupuesto con una persona o un grupo desde la pestaña Manage access. Un administrador delegado puede crear presupuestos dentro de él y establecer límites y límites temporales en esos presupuestos hijos. La delegación debe habilitarse por separado; ponte en contacto con tu equipo de gestión de cuentas.
- Un administrador delegado no puede aumentar el límite del propio presupuesto compartido. Solo puede cambiarlo un administrador que gestione el presupuesto padre.
- Los miembros ven su propio consumo y su límite en My Analytics.

Pestaña Manage access del presupuesto Engineering, con Bob como gestor
Preguntas frecuentes
¿Pueden los Admin de org establecer el límite de ACU de una organización?
¿Pueden los Admin de org establecer el límite de ACU de una organización?
¿Por qué el endpoint de límite de organización devuelve 409?
¿Por qué el endpoint de límite de organización devuelve 409?
409 cuando la organización comparte su presupuesto con otras organizaciones o cuando está directamente en el presupuesto de la cuenta. El mensaje de error es «This organization has no limit of its own. Set the limit on its budget.». Por ejemplo, si Globex, Initech y Umbrella comparten un presupuesto, una operación de escritura del límite de Globex devuelve 409.¿Cuándo se restablecen los límites?
¿Cuándo se restablecen los límites?
¿Puede una organización estar en dos presupuestos?
¿Puede una organización estar en dos presupuestos?
Gestionar presupuestos con la API V3
Todas las solicitudes se autentican con un token de usuario de servicio de la empresa. Quienes realicen las llamadas necesitan el permiso de cuenta ManageAcuLimits o acceso delegado al presupuesto. Usahttps://api.devin.ai como URL base. Consulta la descripción general de la API V3 para obtener instrucciones sobre la autenticación y los usuarios de servicio.
Los endpoints de colección específicos del presupuesto incluyen el presupuesto en la ruta: /v3beta1/enterprise/usage-policies/budgets/{budget_id}/.... Los endpoints que hacen referencia a un único nivel o solicitud (/tiers/{tier_id}, /requests/{request_id}) determinan el presupuesto a partir del nivel o la solicitud, por lo que comparten sus rutas con los endpoints de toda la cuenta.
Semántica de PATCH
En los endpointsPATCH:
- Si se omite un campo, no se modifica.
- Si un campo se establece en
null, se borra. - Si un campo se establece en un valor, se crea o se actualiza.
Endpoints de presupuesto
Listar presupuestos
budget_id: el identificador que se usa en las rutas específicas del presupuesto.parent_budget_id: el presupuesto padre;nullpara el presupuesto raíz de la cuenta.org_ids: las organizaciones vinculadas a este presupuesto. Su consumo se imputa a este presupuesto. Está vacío si no hay ninguna organización vinculada.status:activeoarchived.cycle_acu_limit: el límite del presupuesto para el consumo de ACU que se le imputa a él y a sus descendientes en cada período de facturación mensual;nullsignifica que no hay límite.temporary_cycle_acu_limit: un límite que anulacycle_acu_limithasta el final del período de facturación mensual actual;nullsi no hay ninguno vigente.
Actualizar un presupuesto
null borra un límite. Se requiere al menos un campo.
parent_budget_id: mueve el presupuesto, junto con sus subpresupuestos, a otro presupuesto activo. El presupuesto raíz no se puede mover, y los presupuestos admiten como máximo tres niveles de anidamiento.cycle_acu_limit,temporary_cycle_acu_limit: los límites del presupuesto, igual que en la respuesta de listado.
temporary_cycle_acu_limit, se reinicia para el período actual. En un presupuesto vinculado exactamente a una organización, cycle_acu_limit también pasa a ser el límite de ACU de la organización.
Endpoints de niveles
Listar niveles
priority más alto y, dentro de una misma prioridad, primero el nivel más reciente. Cada nivel tiene esta estructura:
is_default: indica si este es el nivel predeterminado del presupuesto.cycle_acu_limit: el límite de ACU predeterminado por ciclo para cada miembro;nullsignifica sin límite.policy: cómo se gestionan las solicitudes de aumento del límite para el nivel:unconditionalyconditionallas aprueban hastamax_limit, mientras quemanualrequiere la revisión de un administrador.max_limit: el límite máximo hasta el que se aprueban las solicitudes de aumento;nulllas aprueba sin tope. Siempre esnullcuandocycle_acu_limitesnull.priority: determina la prioridad del nivel entre los niveles que un usuario tiene asignados mediante un grupo del IdP: prevalece el valor más alto y, en caso de empate, el nivel más reciente. Una asignación explícita del usuario anula esta prioridad, y el nivel predeterminado nunca se tiene en cuenta en ella.member_count: el número de usuarios que pertenecen actualmente al nivel. En el caso del nivel predeterminado, incluye a todos los miembros del presupuesto que no están en otro nivel.
Crear un nivel
201 con el nivel creado.
Obtener un nivel
Actualizar un nivel
Eliminar un nivel
204 si la operación se completa correctamente. El nivel predeterminado no se puede eliminar (primero debes promover otro nivel). Si un nivel todavía tiene usuarios, primero debes moverlos a otro nivel y quitar todas las asignaciones de grupo de IdP vinculadas a ese nivel.
Endpoints de usuarios por nivel
Listar los usuarios de un nivel
cycle_acu_limit_override: la anulación permanente del usuario, si existe.temporary_cycle_acu_limit: la anulación temporal del usuario; solo aparece mientras esté vigente en el período de facturación mensual actual.effective_cycle_acu_limit: el límite que se aplica actualmente al usuario;nullsignifica sin límite.limit_source: el origen del límite efectivo:override(permanente),temporary_overrideotier.membership: el motivo por el que el usuario pertenece al nivel:explicit(asignado directamente),idp_group(a través de la asignación de grupo de IdP que prevalece) odefault(fallback al nivel predeterminado).
Asignar un usuario a un nivel
204 si la operación se completa correctamente. Al mover a un usuario desde otro nivel, se borra cualquier configuración específica por usuario, por lo que pasa a heredar el límite del nivel de destino.
Eliminar un usuario de un nivel
204 si la operación se realiza correctamente.
Endpoints de usuario
Obtener los límites de un usuario
tier_id/tier_name: el nivel del que se deriva el límite del usuario (asignación explícita, asignación de grupo de IdP o el nivel predeterminado);nullcuando el presupuesto no tiene niveles.tier_cycle_acu_limit: el límite propio del nivel antes de aplicar cualquier anulación;nullsignifica sin límite.pending_request_id/pending_request_cycle_acu_limit: la solicitud de aumento del límite pendiente del usuario y el límite que solicita, si la hay.
Establecer o borrar la anulación de un usuario
kind es obligatorio al establecer un valor: permanent nunca caduca; temporary caduca al final del período de facturación mensual actual.
Cuerpo de la solicitud: borrar todas las excepciones
204 si la operación se completa correctamente.
Endpoints de grupos del IdP
Asocia un grupo del IdP a un nivel para que sus miembros hereden ese nivel automáticamente. Las asignaciones se resuelven en tiempo real a partir de la pertenencia a grupo y nunca modifican la asignación explícita de nivel de un usuario: una asignación explícita siempre prevalece. Si un usuario pertenece a varios grupos asociados, se le asigna el nivel asociado highest-ranked (el nivel con mayorpriority; en caso de empate, prevalece el nivel más reciente).
Listar asignaciones de grupos de IdP
?tier_id= para listar solo los grupos asociados a un nivel concreto:
Obtener la asignación de un grupo del IdP
404 si el grupo no tiene ninguna asignación en el presupuesto.
Asociar un grupo del IdP a un nivel
Desasociar un grupo del IdP
204 si la operación se realiza correctamente. El nivel asociado deja de aplicarse a los miembros del grupo; los usuarios que no tengan una asignación explícita ni otro nivel asociado pasan al nivel predeterminado.
Endpoints de solicitudes de aumento del límite
Los usuarios pueden solicitar un límite por ciclo más alto. Lapolicy del nivel del solicitante determina qué ocurre: con unconditional y conditional, la solicitud se aprueba automáticamente hasta el max_limit del nivel, mientras que con manual queda retenida hasta que un administrador la revise mediante estos endpoints.
Listar solicitudes de aumento del límite
?status= (pending, approved, denied, expired) y ?user_id=:
tier_id/tier_name: el nivel del solicitante dentro del presupuesto;nullcuando el presupuesto no tiene niveles.current_cycle_acu_limit: el límite que se aplica actualmente al solicitante;nullsignifica que no hay límite.status:expiredindica que la solicitud seguía pendiente al finalizar su ciclo de facturación.reviewer: el administrador que revisó la solicitud;nullmientras esté pendiente.
Obtener una solicitud de aumento del límite
Aprobar una solicitud de aumento del límite
409 si la solicitud ya se revisó o si el solicitante ya no es miembro de la cuenta.
Denegar una solicitud de aumento del límite
409 si ya se revisó.

