Plafonds d’ACU par utilisateur

Cette documentation concerne les déploiements fédéraux de Devin. Retour à la documentation Devin

Consultez et gérez les dérogations de plafond d’ACU par utilisateur. Une dérogation utilisateur prévaut sur les limites de team et de groupe — consultez Limites d’ACU pour savoir comment la limite effective est déterminée. Ces endpoints sont disponibles uniquement dans les déploiements fédéraux multitenants. Ils utilisent Teams Read-Only pour la lecture et Teams Update pour l’écriture. Les deux endpoints sélectionnent l’utilisateur à l’aide d’un objet user contenant exactement l’un des éléments suivants :

string

L’adresse e-mail de l’utilisateur.

string

L’ID stable de l’utilisateur, tel que renvoyé par l’API (par exemple dans les lignes de membres de groupe ou de consommation d’ACU).

Les clés de service limitées à un groupe ne peuvent sélectionner que les membres actuels du groupe qui leur est attribué ; pour les autres utilisateurs, elles renvoient not_found. Consultez la vue d’ensemble de l’API pour l’authentification et les erreurs. L’objet de plafond renvoyé par les deux endpoints :

Champ	Description
`user_id`	L’ID stable de l’utilisateur.
`email`	L’adresse e-mail de l’utilisateur.
`configured_cycle_acu_limit`	La dérogation directe par utilisateur, si elle est définie. Une valeur de `0` signifie que l’utilisateur est bloqué. Omis lorsqu’aucune dérogation n’existe.
`effective_cycle_acu_limit`	Le plafond réellement appliqué à l’utilisateur après prise en compte de la dérogation et des limites de team et de groupe. Omis lorsqu’aucune limite ne s’applique.

Obtenir le plafond d’ACU d’un utilisateur

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
  }
}

Définir ou supprimer le plafond d’ACU d’un utilisateur

POST /api/v1/UpdateUserAcuCap

Vous devez fournir exactement l’un des paramètres suivants :

number

Définit la dérogation de limite d’ACU par cycle pour l’utilisateur. Doit être supérieure ou égale à zéro ; 0 empêche l’utilisateur de consommer des ACU.

boolean

Supprime la dérogation de l’utilisateur afin que les limites de la Team et du groupe s’appliquent de nouveau.

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 réponse contient l’objet cap mis à jour.

Une dérogation utilisateur définie sur 0 bloque l’utilisateur. L’API des groupes de clés de service n’accepte pas de plafond de groupe égal à zéro : set_cycle_acu_limit doit être positif et clear_cycle_acu_limit supprime la dérogation de groupe. L’opération distincte du portail relative à la limite de groupe interprète 0 comme une suppression. Consultez Valeurs zéro et non définies.

​Obtenir le plafond d’ACU d’un utilisateur

​Définir ou supprimer le plafond d’ACU d’un utilisateur

Obtenir le plafond d’ACU d’un utilisateur

Définir ou supprimer le plafond d’ACU d’un utilisateur