Límites de ACU por usuario

Esta documentación corresponde a los despliegues federales de Devin. Volver a la documentación de Devin

Consulta y gestiona las anulaciones manuales de ACU por usuario. Una anulación reemplaza los límites de ACU de grupo del usuario, pero el límite de ACU del equipo sigue acotando el consumo total del equipo; consulta Límites de ACU. Estos endpoints solo están disponibles en despliegues federales multi-tenant. Usan Teams Read-Only para las lecturas y Teams Update para las escrituras. Ambos endpoints seleccionan al usuario mediante un objeto user que contiene exactamente uno de los siguientes campos:

string

La dirección de correo electrónico del usuario.

string

El ID estable del usuario, tal como lo devuelve la API (por ejemplo, en filas de miembros de un grupo o de consumo de ACU).

Las claves de servicio con ámbito de grupo solo pueden seleccionar miembros actuales del grupo asignado; para otros usuarios se devuelve not_found. Consulta la descripción general de la API para obtener información sobre autenticación y errores. El objeto de límite que devuelven ambos endpoints:

Campo	Descripción
`user_id`	El ID estable del usuario.
`email`	El correo electrónico del usuario.
`configured_cycle_acu_limit`	La anulación directa por usuario, si se ha establecido. Un valor de `0` significa que el usuario está bloqueado. Se omite si no existe ninguna anulación.
`effective_cycle_acu_limit`	El límite por usuario que se aplica al usuario: su anulación, si se ha establecido una; de lo contrario, su límite de ACU de grupo más alto. Se omite si no se aplica ningún límite. No incluye el límite de ACU del equipo, que se comprueba por separado con respecto al consumo total del equipo.

Obtener el límite de ACU de un usuario

POST /api/v1/GetUserAcuCap

curl -X POST https://<your-server>/api/v1/GetUserAcuCap \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "user": {"email": "dev@agency.gov"}
  }'

{
  "cap": {
    "userId": "user_abc",
    "email": "dev@agency.gov",
    "configuredCycleAcuLimit": 25,
    "effectiveCycleAcuLimit": 25
  }
}

Establecer o quitar el límite de ACU de un usuario

POST /api/v1/UpdateUserAcuCap

Se debe proporcionar exactamente uno de los siguientes:

number

Establece la anulación del límite de ACU por ciclo del usuario. Debe ser un valor no negativo; 0 impide que el usuario consuma ACU.

boolean

Elimina la anulación del usuario para que vuelvan a aplicarse los límites de ACU de su grupo.

curl -X POST https://<your-server>/api/v1/UpdateUserAcuCap \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "user": {"email": "dev@agency.gov"},
    "set_cycle_acu_limit": 25
  }'

La respuesta contiene el objeto cap actualizado.

Una anulación de usuario de 0 bloquea al usuario. La API de grupos de claves de servicio no acepta un límite de grupo de cero: set_cycle_acu_limit debe ser positivo y clear_cycle_acu_limit elimina la anulación del grupo. La operación independiente del portal para establecer el límite de grupo considera que 0 como una eliminación. Consulta Límites de ACU.

​Obtener el límite de ACU de un usuario

​Establecer o quitar el límite de ACU de un usuario

Obtener el límite de ACU de un usuario

Establecer o quitar el límite de ACU de un usuario