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 de límites de ACU por usuario. Una anulación por usuario prevalece sobre los límites de equipo y grupo; consulta Límites de ACU para saber cómo se determina el límite efectivo. 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 que se aplica realmente al usuario después de combinar la anulación con los límites de equipo y grupo. Se omite si no se aplica ningún límite.

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 del equipo y del 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 Valores cero y no establecidos.

​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