Saltar al contenido principal
Los presupuestos te permiten limitar el consumo de ACU según la estructura de tu empresa: un límite para la cuenta, fondos compartidos para equipos o proyectos y límites por usuario dentro de cada fondo.

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.
Presupuesto de la cuenta de 100,000 ACU, con Engineering en 30,000 ACU (que incluye Payments y Search) y Marketing en 5,000 ACU.

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.
Página Presupuestos vista por un administrador de departamento

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

Aumento del límite de un presupuesto hijo

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

El límite del presupuesto del departamento es de solo lectura

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.
Developer tools con 20,000 ACU y un nivel predeterminado de 200 ACU, y Migration initiative con 5,000 ACU y un nivel predeterminado de 1,000 ACU.

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

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.
Presupuesto de la cuenta de 100,000 ACU con Engineering en 40,000 ACU y sus tres presupuestos hijos, y Developer tools en 20,000 ACU con tres niveles de límite por usuario.

Árbol de presupuestos con presupuestos y niveles de límite por usuario

Los niveles son límites por usuario dentro de un mismo presupuesto, no presupuestos independientes.
Árbol de presupuestos con el uso de cada presupuesto

Á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ímite null 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.
Un presupuesto vinculado a una única organización comparte su límite con esa organización. Los endpoints deprecados de límite de ACU a nivel de organización también lo establecen. También puedes usar el endpoint de actualización que se describe más abajo.

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: límite de consumo alcanzado

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.
Presupuesto de Marketing con un límite temporal

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. unconditional y conditional aprueban las solicitudes hasta el max_limit del nivel. manual enví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.
Un límite de usuario en un presupuesto padre no se extiende a sus presupuestos hijos. Por ejemplo, si Engineering también contiene una organización, un límite de usuario de 300 ACU en Engineering no limita el consumo de un usuario en Payments o Search.
Diálogo Copiar políticas de uso

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

Pestaña Manage access del presupuesto Engineering, con Bob como gestor

Preguntas frecuentes

No. Los límites de ACU de las organizaciones los establecen los Admin de Enterprise. Para que un equipo gestione sus propios límites, comparte un presupuesto con el administrador del equipo.
Una vez que se hacen cumplir los límites de presupuesto en tu empresa, el endpoint de límite de organización devuelve HTTP 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.
Al inicio de cada período mensual, que comienza el día de inicio de tu fase de facturación.
No. Cada organización pertenece a un único presupuesto, pero un presupuesto puede contener varias organizaciones.

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. Usa https://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 endpoints PATCH:
  • 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

Devuelve una lista paginada de los presupuestos de la cuenta, tanto activos como archivados. Cada presupuesto tiene el siguiente formato:
  • budget_id: el identificador que se usa en las rutas específicas del presupuesto.
  • parent_budget_id: el presupuesto padre; null para 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: active o archived.
  • 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; null significa que no hay límite.
  • temporary_cycle_acu_limit: un límite que anula cycle_acu_limit hasta el final del período de facturación mensual actual; null si no hay ninguno vigente.

Actualizar un presupuesto

Actualización parcial: los campos omitidos no se modifican y 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.
Cuerpo de la solicitud: establecer el límite y un aumento temporal para este mes
Cuerpo de la solicitud — eliminar los límites
Cuerpo de la solicitud: mover el presupuesto a otro presupuesto
Devuelve el presupuesto actualizado. Si vuelves a establecer 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

Devuelve una lista paginada de los niveles del presupuesto en orden de precedencia: primero el 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; null significa sin límite.
  • policy: cómo se gestionan las solicitudes de aumento del límite para el nivel: unconditional y conditional las aprueban hasta max_limit, mientras que manual requiere la revisión de un administrador.
  • max_limit: el límite máximo hasta el que se aprueban las solicitudes de aumento; null las aprueba sin tope. Siempre es null cuando cycle_acu_limit es null.
  • 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

Cuerpo de la solicitud
El primer nivel del presupuesto se convierte automáticamente en su nivel predeterminado. Devuelve HTTP 201 con el nivel creado.

Obtener un nivel

Actualizar un nivel

Actualización parcial: los campos omitidos se mantienen sin cambios.

Eliminar un nivel

Devuelve HTTP 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

Devuelve una lista paginada de los usuarios del nivel con sus límites resueltos. En el caso del nivel predeterminado, incluye a todos los miembros del presupuesto que no pertenecen a ningún otro 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; null significa sin límite.
  • limit_source: el origen del límite efectivo: override (permanente), temporary_override o tier.
  • 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) o default (fallback al nivel predeterminado).

Asignar un usuario a un nivel

Idempotente. Devuelve HTTP 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

Elimina la asignación explícita de nivel del usuario (y cualquier anulación). A partir de ese momento, al usuario se le aplica su nivel asignado mediante un grupo del IdP, si existe, o, en su defecto, el nivel predeterminado. Devuelve HTTP 204 si la operación se realiza correctamente.

Endpoints de usuario

Obtener los límites de un usuario

Devuelve el nivel resuelto del usuario, sus límites y la solicitud pendiente dentro del presupuesto. Incluye los campos de usuario del nivel descritos anteriormente, además de:
  • 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); null cuando el presupuesto no tiene niveles.
  • tier_cycle_acu_limit: el límite propio del nivel antes de aplicar cualquier anulación; null significa 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

User-scoped: el usuario de destino solo necesita ser miembro del presupuesto; no interviene ningún nivel y la asignación de nivel del usuario nunca se modifica. Cuerpo de la solicitud: establecer una anulación temporal
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
El endpoint devuelve HTTP 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 mayor priority; en caso de empate, prevalece el nivel más reciente).

Listar asignaciones de grupos de IdP

Devuelve una lista paginada de las asignaciones de grupos a niveles del presupuesto, de la más antigua a la más reciente. Filtra con ?tier_id= para listar solo los grupos asociados a un nivel concreto:

Obtener la asignación de un grupo del IdP

Devuelve HTTP 404 si el grupo no tiene ninguna asignación en el presupuesto.

Asociar un grupo del IdP a un nivel

Cuerpo de la solicitud
Upsert idempotente. El nivel debe pertenecer al presupuesto. Un grupo solo puede estar asociado a un nivel por presupuesto, por lo que, si se asocia un grupo que ya lo está, este pasa al nivel indicado.

Desasociar un grupo del IdP

Devuelve HTTP 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. La policy 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

Devuelve una lista paginada de las solicitudes del presupuesto, filtrable con ?status= (pending, approved, denied, expired) y ?user_id=:
  • tier_id / tier_name: el nivel del solicitante dentro del presupuesto; null cuando el presupuesto no tiene niveles.
  • current_cycle_acu_limit: el límite que se aplica actualmente al solicitante; null significa que no hay límite.
  • status: expired indica que la solicitud seguía pendiente al finalizar su ciclo de facturación.
  • reviewer: el administrador que revisó la solicitud; null mientras esté pendiente.

Obtener una solicitud de aumento del límite

Aprobar una solicitud de aumento del límite

Concede el límite solicitado como una anulación temporal que vence al final del período de facturación mensual actual. Opcionalmente, puedes conceder un límite distinto:
Devuelve la solicitud actualizada. Devuelve HTTP 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

Devuelve la solicitud actualizada o HTTP 409 si ya se revisó.

Ejemplos de flujos de trabajo

Configurar los niveles de un presupuesto

Busca el presupuesto, establece un límite de 2000 ACU al mes y luego crea un nivel predeterminado para que cada miembro del presupuesto tenga un límite mensual de 500 ACU:
Asocia un grupo del IdP al nivel y concede a un usuario un aumento temporal para lo que queda de mes: