Limites de ACU por usuário

Esta documentação é destinada às implantações federais do Devin. Voltar para a documentação do Devin

Consulte e gerencie overrides manuais de ACU por usuário. Um override substitui os limites de ACU de grupo do usuário, mas o limite de ACU da equipe continua impondo um teto ao uso total da equipe — consulte Limites de ACU. Estes endpoints estão disponíveis apenas em implantações federais multilocatárias. Eles usam Teams Read-Only para leitura e Teams Update para gravação. Ambos os endpoints selecionam o usuário por meio de um objeto user que contém exatamente um dos seguintes campos:

string

O endereço de e-mail do usuário.

string

O ID estável do usuário, conforme retornado pela API (por exemplo, em registros de membros de grupo ou de consumo de ACU).

Chaves de serviço com escopo de grupo só podem selecionar membros atuais do grupo atribuído; para outros usuários, retornam not_found. Consulte a visão geral da API para informações sobre autenticação e erros. O objeto cap retornado por ambos os endpoints:

Campo	Descrição
`user_id`	O ID estável do usuário.
`email`	O e-mail do usuário.
`configured_cycle_acu_limit`	O override direto por usuário, se estiver definido. Um valor de `0` significa que o usuário está bloqueado. Omitido quando não há override.
`effective_cycle_acu_limit`	O limite por usuário aplicado ao usuário: o override, se houver um definido; caso contrário, o maior limite de ACU entre seus grupos. Omitido quando nenhum limite se aplica. Não inclui o limite de ACU da equipe, que é verificado separadamente em relação ao uso total da equipe.

Obter o limite de ACUs de um usuário

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

Definir ou remover o limite de ACUs de um usuário

POST /api/v1/UpdateUserAcuCap

Exatamente um dos seguintes itens deve ser fornecido:

number

Define o override de ACUs do usuário por ciclo. Deve ser não negativo; 0 impede o usuário de consumir ACUs.

boolean

Remove o override do usuário para que os limites de ACU do grupo dele voltem a ser aplicados.

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

A resposta contém o objeto cap atualizado.

Um override de usuário de 0 bloqueia o usuário. A API de grupos de chaves de serviço não aceita um limite de grupo igual a zero: set_cycle_acu_limit deve ser positivo, e clear_cycle_acu_limit remove o override do grupo. A operação separada do portal para limites de grupo trata 0 como remoção do limite. Consulte Limites de ACU.

​Obter o limite de ACUs de um usuário

​Definir ou remover o limite de ACUs de um usuário

Obter o limite de ACUs de um usuário

Definir ou remover o limite de ACUs de um usuário