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ç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.

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

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

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.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 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.Árvore de orçamentos com orçamentos e níveis de limite por usuário

Á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 limitenull 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.
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 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.
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.
unconditionaleconditionalaprovam requisições até omax_limitdo nível.manualencaminha 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.

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, com Bob como gestor
Perguntas frequentes
Os administradores da organização podem definir o limite de ACU de uma organização?
Os administradores da organização podem definir o limite de ACU de uma organização?
Por que o endpoint de limite da organização retorna 409?
Por que o endpoint de limite da organização retorna 409?
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.Quando os limites são redefinidos?
Quando os limites são redefinidos?
Uma organização pode estar em dois orçamentos?
Uma organização pode estar em dois orçamentos?
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. Usehttps://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 endpointsPATCH:
- 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
budget_id: o identificador a ser usado em caminhos budget-scoped.parent_budget_id: o orçamento pai;nullpara 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:activeouarchived.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;nullsignifica sem limite.temporary_cycle_acu_limit: um limite que substituicycle_acu_limitaté o fim do período mensal de faturamento atual;nullquando não houver nenhum em vigor.
Atualizar um orçamento
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.
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
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;nullsignifica sem limite.policy: define como as requisições de aumento de limite para o nível são tratadas —unconditionaleconditionalaprovam atémax_limit, emanualexige revisão de um administrador.max_limit: o limite máximo até o qual as solicitações de aumento são aprovadas;nullaprova sem teto. É semprenullquandocycle_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
201 com o nível criado.
Obter um nível
Atualizar um nível
Excluir um nível
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
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;nullsignifica sem limite.limit_source: a origem do limite efetivo —override(permanente),temporary_overrideoutier.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) oudefault(fallback para o nível padrão).
Atribuir um usuário a um nível
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
204 em caso de sucesso.
Endpoints de usuário
Obter os limites de um usuário
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);nullquando o orçamento não tem níveis.tier_cycle_acu_limit: o limite do próprio nível, antes de qualquer override;nullsignifica 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
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
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 (maiorpriority do nível; em caso de empate, prevalece o nível mais recente).
Listar mapeamentos de grupos do IdP
?tier_id= para listar apenas os grupos mapeados para um determinado nível:
Obter o mapeamento de um grupo do IdP
404 se o grupo não tiver mapeamento no orçamento.
Mapear um grupo do IdP para um nível
Remover o mapeamento de um grupo do IdP
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. Apolicy 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
?status= (pending, approved, denied, expired) e ?user_id=:
tier_id/tier_name: o nível do solicitante no orçamento;nullquando o orçamento não tem níveis.current_cycle_acu_limit: o limite atualmente imposto ao solicitante;nullsignifica sem limite.status:expiredsignifica que a requisição ainda estava pendente quando o ciclo de faturamento correspondente terminou.reviewer: o administrador que revisou a requisição;nullenquanto ela estiver pendente.
Obter uma requisição de aumento de limite
Aprovar uma requisição de aumento de limite
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
409 se ela já tiver sido revisada.

