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 manuelles d’ACU par utilisateur. Une dérogation remplace les limites d’ACU de groupe de l’utilisateur, mais la limite d’ACU de l’équipe continue de plafonner l’utilisation totale de l’équipe — consultez Limites d’ACU. 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 cap 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`	La limite par utilisateur appliquée à l’utilisateur : sa dérogation si elle est définie, sinon sa limite d’ACU de groupe la plus élevée. Omis lorsqu’aucune limite ne s’applique. N’inclut pas la limite d’ACU de l’équipe, qui est vérifiée séparément par rapport à l’utilisation totale de l’équipe.

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 d’ACU de son 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 Limites d’ACU.

​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