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 de limite de ACU por usuário. Um override por usuário tem precedência sobre os limites de equipe e grupo — consulte Limites de ACU para entender como o limite efetivo é determinado. 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 de limite 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 efetivamente aplicado ao usuário após combinar o override com os limites de equipe e grupo. Omitido quando nenhum limite se aplica.

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 da equipe e do grupo 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 Valores zero e não definidos.

​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