Pular para o conteúdo principal
Com os orçamentos, você limita o uso de ACU de acordo com a estrutura da sua empresa: um limite para a conta, pools compartilhados para equipes ou projetos e limites por usuário dentro de cada pool.

Exemplos de casos de uso

Departamentos com administradores delegados

A Acme Corp tem 10 departamentos. Cada chefe de departamento gerencia os limites das suas organizações, e a TI central define o total de cada departamento. Este exemplo mostra dois deles. Alice, a administradora do Enterprise, cria um orçamento para cada departamento abaixo do orçamento da Account e compartilha cada um com o administrador do respectivo departamento. Cada administrador de departamento, por sua vez, cria um orçamento para cada uma das suas organizações.
Orçamento Account de 100,000 ACU, com Engineering em 30,000 ACU, contendo Payments e Search, e Marketing em 5,000 ACU.

Orçamentos de departamento abaixo do orçamento Account

  • Bob, administrador do departamento Engineering, pode definir limites e limites temporários em qualquer orçamento abaixo de Engineering. Por exemplo, ele pode dar a Payments um limite temporário de 6,000 ACU durante uma semana de alta demanda.
  • Bob não pode aumentar o limite de 30,000 ACU de Engineering. Somente Alice pode fazer isso.
  • O uso em todas as organizações de Engineering é contabilizado no limite de 30,000 ACU, mesmo quando a soma dos orçamentos das organizações ultrapassa esse valor.
Página Orçamentos vista por um administrador de departamento

A página Budgets vista por um administrador de departamento, com o orçamento Account bloqueado

Aumentando o limite de um orçamento filho

Um administrador de departamento aumentando o limite de um orçamento filho

O limite do orçamento do departamento é somente leitura

Um administrador de departamento não pode alterar o limite do orçamento do departamento

Um orçamento de projeto com limites mais altos por usuário

Cada desenvolvedor recebe 200 ACUs por mês. Para a iniciativa de migração, a Acme Corp reserva 5,000 ACUs e permite que as pessoas do projeto usem mais. Mantenha as organizações de Ferramentas do Desenvolvedor em um orçamento Ferramentas do Desenvolvedor com um nível padrão de 200 ACUs. Crie um orçamento Migration initiative com um limite de 5,000 ACUs. Coloque nele a organização do projeto e defina um nível padrão de 1,000 ACUs. Os dois orçamentos ficam abaixo do orçamento da Account.
Developer tools com 20,000 ACUs e um nível padrão de 200 ACUs, e Migration initiative com 5,000 ACUs e um nível padrão de 1,000 ACUs.

Orçamentos Developer tools e Migration initiative com seus níveis

  • Carol, desenvolvedora do projeto, pode usar até 1,000 ACUs na organização Migration e até 200 ACUs nas organizações de Ferramentas do Desenvolvedor.
  • O projeto como um todo nunca pode usar mais de 5,000 ACUs por mês.
Seletor de orçamento do My Analytics

Seletor de orçamento do My Analytics com vários orçamentos

Como os orçamentos funcionam

Árvore de orçamentos

Cada conta Enterprise tem uma árvore de orçamentos. A raiz é o orçamento da Account, e os orçamentos filhos ficam abaixo dele. Uma árvore pode ter até três níveis de profundidade. Um orçamento pode conter uma ou várias organizações. Cada organização pertence a exatamente um orçamento. Novas organizações ficam sob o orçamento da Account. Por exemplo, a Acme Corp define um limite de 100,000 ACU no orçamento da Account. A Engenharia divide seu pool em três orçamentos filhos.
Orçamento da conta de 100,000 ACU com Engenharia em 40,000 ACU e seus três orçamentos filhos, e Ferramentas de desenvolvimento em 20,000 ACU com três níveis de limite por usuário.

Árvore de orçamentos com orçamentos e níveis de limite por usuário

Os níveis são limites por usuário dentro de um único orçamento, e não orçamentos separados.
Árvore de orçamentos com a utilização de cada orçamento

Árvore de orçamentos com a utilização de cada orçamento (dados fictícios)

Limites de orçamento

Um limite de orçamento restringe o uso de ACU combinado das organizações do orçamento e das organizações em seus orçamentos filhos, dentro de um período mensal. Um limite null significa ilimitado.
  • O uso conta para todos os ancestrais. O uso em um orçamento filho também conta para o orçamento pai e para o orçamento da Account.
  • Um ancestral esgotado bloqueia seus filhos. Quando qualquer orçamento no caminho se esgota, o uso nesse ramo é interrompido.
  • A soma dos limites dos filhos pode ultrapassar o limite do pai. Ainda assim, o limite do pai restringe o uso combinado deles.
  • Um orçamento sem limite continua restrito pelos seus pais.
Um orçamento vinculado a exatamente uma organização compartilha o limite com essa organização. Os endpoints obsoletos de limite de ACU organization-level também definem esse limite. Você também pode usar o endpoint de atualização abaixo.

O que acontece quando um orçamento se esgota

Quando um orçamento se esgota, o uso é interrompido nas organizações vinculadas a ele. O uso também é interrompido quando qualquer orçamento pai se esgota. O uso é retomado no próximo período mensal ou quando um administrador aumenta o limite ou define um limite temporário.
  • Sessões do Devin: não é possível iniciar novas sessões, e as sessões em execução entram em suspensão. Os usuários veem a mensagem “Increase your organization’s usage limit.”
  • Devin CLI e agente local do Desktop: as requisições são bloqueadas. Os usuários veem a mensagem “Your organization has reached its monthly usage limit. Ask an account admin to raise it, or wait for the limit to reset next month.”
  • Devin Review: novas revisões são bloqueadas.
Banner do compositor: limite de uso atingido

Banner do compositor quando o orçamento se esgota

Período mensal

Os limites do orçamento, os limites de usuário e os limites temporários são redefinidos no início de cada período mensal. Cada período começa no dia de início da sua fase de faturamento, que nem sempre coincide com o mês do calendário. Por exemplo, se a fase de faturamento começa no dia 15, os períodos vão de 15 de outubro a 14 de novembro e, em seguida, de 15 de novembro a 14 de dezembro. Um limite temporário substitui o limite do orçamento pelo restante do período atual. O limite permanente volta a valer no período seguinte. Uma substituição temporária específica do usuário expira no fim do período atual.
Orçamento de Marketing com um limite temporário

Um limite temporário aumenta o orçamento de Marketing para 6,000 ACUs somente neste período

Limites de usuário em um orçamento

Os limites de usuário restringem quanto uma pessoa pode consumir em um período mensal. Cada orçamento com uma organização vinculada tem seus próprios limites de usuário, que valem somente dentro desse orçamento.
  • Níveis. Cada orçamento tem seus próprios níveis e um nível padrão. Um nível define o limite mensal de ACU para seus membros.
  • Mapeamentos de grupos do IdP. Mapeie um grupo do provedor de identidade para um nível. Os membros do grupo passam a pertencer a esse nível.
  • Overrides. Defina um limite permanente ou temporário para um usuário específico.
  • Políticas de requisição. Cada nível define como as solicitações de aumento de limite são tratadas. unconditional e conditional aprovam requisições até o max_limit do nível. manual encaminha as requisições a um administrador para revisão.
  • Escopo. Um limite de usuário considera apenas o uso do usuário nas organizações desse orçamento.
  • Copiar e limpar. Copie níveis de outro orçamento ou da conta. Você também pode copiar mapeamentos de grupos do IdP, atribuições e overrides. Para começar do zero, limpe todos os níveis de um orçamento.
Um limite de usuário em um orçamento pai não se estende aos orçamentos filhos. Por exemplo, se Engineering também tiver uma organização, um limite de usuário de 300 ACU em Engineering não limita o uso de um usuário em Payments ou Search.
Caixa de diálogo Copiar políticas de uso

Caixa de diálogo Copiar políticas de uso com Developer tools como origem

Quem pode gerenciar um orçamento

Os admins do Enterprise gerenciam orçamentos em Enterprise Settings, na seção Orçamentos. Eles gerenciam toda a hierarquia, incluindo o orçamento da Account.
  • Delegação. Um administrador do Enterprise pode compartilhar um orçamento com uma pessoa ou um grupo na aba Manage access. Um administrador delegado pode criar orçamentos abaixo dele e definir limites e limites temporários nesses orçamentos filhos. A delegação precisa ser ativada separadamente; para isso, entre em contato com sua equipe de contas.
  • Um administrador delegado não pode aumentar o limite do próprio orçamento compartilhado. Somente um administrador que gerencia o orçamento pai pode alterá-lo.
  • Membros veem o próprio uso e limite em My Analytics.
Aba Manage access do orçamento Engineering

Aba Manage access do orçamento Engineering, com Bob como gestor

Perguntas frequentes

Não. Os limites de ACU das organizações são definidos pelos administradores do Enterprise. Para que uma equipe gerencie os próprios limites, compartilhe um orçamento com o administrador dessa equipe.
Depois que os limites de orçamento passam a ser impostos na sua empresa, o endpoint de limite da organização retorna HTTP 409 quando a organização compartilha o orçamento com outras organizações ou quando fica diretamente no orçamento da Account. A mensagem de erro é “This organization has no limit of its own. Set the limit on its budget.” Por exemplo, se Globex, Initech e Umbrella compartilham um orçamento, uma gravação de limite para a Globex retorna 409.
No início de cada período mensal. O período começa no dia inicial da sua fase de faturamento.
Não. Cada organização pertence a apenas um orçamento. Um orçamento pode conter várias organizações.

Gerenciar orçamentos com a API V3

Todas as requisições são autenticadas com um token de usuário de serviço da empresa. Quem faz a chamada precisa da permissão de conta ManageAcuLimits ou de acesso delegado ao orçamento. Use https://api.devin.ai como URL base. Consulte a visão geral da API V3 para ver orientações sobre autenticação e usuários de serviço. Os endpoints de coleção budget-scoped recebem o orçamento no caminho: /v3beta1/enterprise/usage-policies/budgets/{budget_id}/.... Os endpoints que se referem a um único nível ou requisição (/tiers/{tier_id}, /requests/{request_id}) identificam o orçamento a partir do nível ou da requisição e, por isso, compartilham os mesmos caminhos dos endpoints no nível da conta.

Semântica do PATCH

Para os endpoints PATCH:
  • Um campo omitido permanece inalterado.
  • Um campo definido como null é apagado.
  • Um campo definido com um valor é criado ou atualizado.

Endpoints de orçamento

Listar orçamentos

Retorna uma lista paginada dos orçamentos da conta, tanto ativos quanto arquivados. Cada orçamento tem o seguinte formato:
  • budget_id: o identificador a ser usado em caminhos budget-scoped.
  • parent_budget_id: o orçamento pai; null para o orçamento raiz da conta.
  • org_ids: as organizações vinculadas a este orçamento. O uso delas é contabilizado nele. Fica vazio quando nenhuma organização está vinculada.
  • status: active ou archived.
  • cycle_acu_limit: o limite do orçamento para o consumo de ACUs cobrado dele e de seus descendentes em cada ciclo de faturamento mensal; null significa sem limite.
  • temporary_cycle_acu_limit: um limite que substitui cycle_acu_limit até o fim do período mensal de faturamento atual; null quando não houver nenhum em vigor.

Atualizar um orçamento

Atualização parcial: campos omitidos permanecem inalterados e null remove um limite. É obrigatório informar pelo menos um campo.
  • parent_budget_id: move o orçamento, junto com seus suborçamentos, para dentro de outro orçamento ativo. O orçamento raiz não pode ser movido, e os orçamentos podem ser aninhados em no máximo três níveis.
  • cycle_acu_limit, temporary_cycle_acu_limit: os limites do orçamento, como na resposta da listagem.
Corpo da requisição — definir o limite e um aumento temporário para este mês
Corpo da requisição — remover os limites
Corpo da requisição — mover o orçamento para dentro de outro orçamento
Retorna o orçamento atualizado. Definir temporary_cycle_acu_limit novamente faz com que ele seja reiniciado para a janela atual. Em um orçamento vinculado a exatamente uma organização, cycle_acu_limit também passa a ser o limite de ACU da organização.

Endpoints de nível

Listar níveis

Retorna uma lista paginada dos níveis do orçamento em ordem de precedência: primeiro os de maior priority e, dentro da mesma prioridade, os mais recentes primeiro. Cada nível tem o seguinte formato:
  • is_default: indica se este é o nível padrão do orçamento.
  • cycle_acu_limit: o limite de ACU padrão por ciclo para cada membro; null significa sem limite.
  • policy: define como as requisições de aumento de limite para o nível são tratadas — unconditional e conditional aprovam até max_limit, e manual exige revisão de um administrador.
  • max_limit: o limite máximo até o qual as solicitações de aumento são aprovadas; null aprova sem teto. É sempre null quando cycle_acu_limit é null.
  • priority: define a posição do nível entre os níveis mapeados a grupos do IdP de um usuário — o maior valor prevalece e, em caso de empate, vence o nível mais recente. Uma atribuição explícita do usuário se sobrepõe a essa classificação, e o nível padrão nunca entra na classificação.
  • member_count: o número de usuários atualmente no nível. No caso do nível padrão, conta todos os membros do orçamento que não estão em outro nível.

Criar um nível

Corpo da requisição
O primeiro nível do orçamento se torna automaticamente o nível padrão dele. Retorna HTTP 201 com o nível criado.

Obter um nível

Atualizar um nível

Atualização parcial: os campos omitidos não são alterados.

Excluir um nível

Retorna HTTP 204 em caso de sucesso. O nível padrão não pode ser excluído (promova outro nível antes). Se o nível ainda tiver usuários, é preciso movê-los primeiro, além de remover todos os mapeamentos de grupos do IdP associados a ele.

Endpoints de usuários por nível

Listar os usuários de um nível

Retorna uma lista paginada dos usuários do nível com seus limites resolvidos. No caso do nível padrão, isso corresponde a todos os membros do orçamento que não pertencem a outro nível:
  • cycle_acu_limit_override: a substituição permanente do usuário, se houver.
  • temporary_cycle_acu_limit: a substituição temporária do usuário, presente apenas enquanto estiver em vigor no período mensal de faturamento atual.
  • effective_cycle_acu_limit: o limite atualmente imposto ao usuário; null significa sem limite.
  • limit_source: a origem do limite efetivo — override (permanente), temporary_override ou tier.
  • membership: por que o usuário está no nível — explicit (atribuído diretamente), idp_group (por meio do mapeamento de grupo do IdP que prevaleceu) ou default (fallback para o nível padrão).

Atribuir um usuário a um nível

Idempotente. Retorna HTTP 204 em caso de sucesso. Mover um usuário de outro nível remove qualquer substituição por usuário, de modo que ele passa a herdar o limite do nível de destino.

Remover um usuário de um nível

Remove a atribuição explícita de nível do usuário (e qualquer override). Com isso, o usuário passa a ser resolvido para o nível mapeado a um grupo do IdP ao qual pertence, se houver; caso contrário, para o nível padrão. Retorna HTTP 204 em caso de sucesso.

Endpoints de usuário

Obter os limites de um usuário

Retorna o nível resolvido do usuário, seus limites e a requisição pendente dentro do orçamento. Inclui os campos de usuário do nível acima, além de:
  • tier_id / tier_name: o nível do qual deriva o limite do usuário (atribuição explícita, mapeamento de grupos do IdP ou nível padrão); null quando o orçamento não tem níveis.
  • tier_cycle_acu_limit: o limite do próprio nível, antes de qualquer override; null significa sem limite.
  • pending_request_id / pending_request_cycle_acu_limit: a requisição de aumento de limite pendente do usuário e o limite solicitado nela, se houver.

Definir ou remover o override de um usuário

Com escopo de usuário: o alvo só precisa ser membro do orçamento — nenhum nível é envolvido, e a atribuição de nível do usuário nunca é alterada. Corpo da requisição — definir uma substituição temporária
kind é obrigatório ao definir um valor: permanent nunca expira; temporary expira ao final do período mensal de faturamento atual. Corpo da requisição — remover todos os overrides
O endpoint retorna HTTP 204 em caso de sucesso.

Endpoints de grupos do IdP

Mapeie um grupo do IdP para um nível para que seus membros herdem esse nível automaticamente. Os mapeamentos são resolvidos em tempo real com base na associação a grupos e nunca alteram a atribuição explícita de nível de um usuário — uma atribuição explícita sempre prevalece. Para um usuário que pertence a vários grupos mapeados, vale o nível mapeado de maior prioridade (maior priority do nível; em caso de empate, prevalece o nível mais recente).

Listar mapeamentos de grupos do IdP

Retorna uma lista paginada dos mapeamentos de grupo para nível do orçamento, do mais antigo para o mais recente. Filtre com ?tier_id= para listar apenas os grupos mapeados para um determinado nível:

Obter o mapeamento de um grupo do IdP

Retorna HTTP 404 se o grupo não tiver mapeamento no orçamento.

Mapear um grupo do IdP para um nível

Corpo da requisição
Upsert idempotente. O nível deve pertencer ao orçamento. Cada grupo pode ser mapeado para no máximo um nível por orçamento; portanto, mapear um grupo que já está mapeado o transfere para o nível especificado.

Remover o mapeamento de um grupo do IdP

Retorna HTTP 204 em caso de sucesso. O nível mapeado deixa de ser aplicado aos membros do grupo; usuários sem atribuição explícita e sem outro nível mapeado voltam para o nível padrão.

Endpoints de requisição de aumento de limite

Os usuários podem solicitar um limite maior por ciclo. A policy do nível do solicitante determina o que acontece: unconditional e conditional aprovam automaticamente até o max_limit do nível, enquanto manual mantém a requisição pendente para revisão de um administrador por meio destes endpoints.

Listar requisições de aumento de limite

Retorna uma lista paginada das requisições do orçamento, que pode ser filtrada com ?status= (pending, approved, denied, expired) e ?user_id=:
  • tier_id / tier_name: o nível do solicitante no orçamento; null quando o orçamento não tem níveis.
  • current_cycle_acu_limit: o limite atualmente imposto ao solicitante; null significa sem limite.
  • status: expired significa que a requisição ainda estava pendente quando o ciclo de faturamento correspondente terminou.
  • reviewer: o administrador que revisou a requisição; null enquanto ela estiver pendente.

Obter uma requisição de aumento de limite

Aprovar uma requisição de aumento de limite

Concede o limite solicitado como uma substituição temporária, que expira ao final do período mensal de faturamento atual. Opcionalmente, você pode conceder um limite diferente:
Retorna a requisição atualizada. Retorna HTTP 409 se a requisição já tiver sido revisada ou se o solicitante não for mais membro da conta.

Negar uma requisição de aumento de limite

Retorna a requisição atualizada ou HTTP 409 se ela já tiver sido revisada.

Exemplos de fluxos de trabalho

Configurar os níveis de um orçamento

Localize o orçamento, defina para ele um limite de 2.000 ACUs por mês e crie um nível padrão para que cada membro do orçamento tenha um limite mensal de 500 ACUs:
Mapeie um grupo do IdP para o nível e conceda a um usuário um aumento temporário até o fim do mês: