Gerenciar orçamentos de gasto máximo

Neste documento, explicamos como criar, editar e excluir orçamentos com limite de gastos em projetos vinculados a uma conta do Cloud Billing.

Neste documento, você vai aprender sobre:

Sobre os orçamentos com gasto máximo

Os gastos máximos nos orçamentos do Cloud Billing ajudam a reduzir custos inesperados ou descontrolados para serviços qualificados. Para ajudar você a acompanhar os gastos em relação ao orçamento, enviamos e-mails de alerta quando os gastos excedem 50%, 80% e 100% do valor do orçamento com limite de gastos.

O gasto máximo é aplicado quando os custos de uso brutos e estimados excedem 100% do valor do orçamento. Quando um orçamento com limite de gastos é aplicado, o uso dos serviços especificados é pausado automaticamente pelo restante do período do orçamento, a menos que você remova o limite de gastos manualmente. No início do próximo período do orçamento, os orçamentos com limite de gastos aplicados são removidos automaticamente, retomando todos os serviços pausados e redefinindo o valor do gasto para zero.

A aplicação também aciona alertas, incluindo notificações por e-mail e banners na UI do console de faturamento, com informações e orientações sobre como remover manualmente o limite.

Como os orçamentos com gasto máximo ajudam a controlar os gastos

Os orçamentos com gasto máximo usam custos brutos e estimados para acionar alertas e aplicar limites de gasto, bloqueando o uso e o acúmulo de custos até que o gasto máximo seja removido.

Cálculos de gastos mais rápidos usando custos estimados

Para uma aplicação mais rápida de um valor de gasto máximo, os orçamentos de gasto máximo usam custos brutos estimados para acionar alertas e aplicar o gasto máximo. Os custos estimados são calculados com base no preço de tabela dos serviços e não incluem economias e créditos.

Ao visualizar um orçamento com limite de gastos, os custos estimados são exibidos na barra de progresso Valor do gasto e do orçamento e no campo Valor do gasto, que fica visível quando você está editando um orçamento com limite de gastos.

Pausa automática do uso e do acúmulo de custos quando o limite de gastos é acionado

No projeto especificado, quando os custos de uso brutos e estimados do serviço específico excederem o valor da meta de orçamento, o gasto máximo será acionado e aplicado pelo restante do período do orçamento. Enquanto estiver em vigor, todo o uso novo do serviço específico no projeto especificado será pausado, incluindo o uso sob demanda, de pagamento por uso e o uso coberto por compromissos, como descontos por compromisso de uso (CUDs). Todas as solicitações em andamento do serviço especificado são processadas até a conclusão, acumulando cobranças conforme aplicável.

Os gastos máximos não pausam o uso fixo e contínuo associado a recursos permanentes (como serviços de recursos computacionais e armazenamento), que permanecem ativos e continuam acumulando cobranças.

Remover um gasto máximo aplicado para restaurar serviços e gastos

Quando um gasto máximo é aplicado, o uso do serviço específico no projeto especificado é bloqueado até que o gasto máximo seja removido. É possível suspender um gasto máximo das seguintes maneiras:

  • Remover automaticamente um gasto máximo: um gasto máximo aplicado é removido automaticamente no início do próximo período de orçamento (normalmente, o primeiro dia do próximo mês). Quando um gasto máximo é removido automaticamente, o valor do gasto do orçamento é redefinido para zero, o status do gasto máximo é redefinido para Configurado e os serviços especificados são desbloqueados, restaurando a função normal das chamadas de API.

  • Remover manualmente um gasto máximo: se você precisar reverter um bloqueio de uso durante o mesmo período de orçamento em que o gasto máximo é aplicado, edite o orçamento para remover manualmente o gasto máximo. A remoção manual de um gasto máximo tem os seguintes resultados:

    • A remoção manual de um gasto máximo restaura a função normal das chamadas de API e muda o status do gasto máximo para Removido pelo restante do período do orçamento.
    • Depois de remover o gasto máximo manualmente, ele não será acionado novamente pelo restante do período de orçamento, a menos que você edite o orçamento para aumentar o valor do gasto máximo.
    • No início do próximo período de orçamento (normalmente o primeiro dia do mês seguinte), o orçamento do gasto máximo é redefinido automaticamente, definindo o valor do gasto como zero e o status do gasto máximo como Configurado.

Depois que um gasto máximo é removido, pode levar até uma hora para que os serviços voltem ao funcionamento normal.

Alertas enviados quando o gasto máximo é acionado

Quando um gasto máximo é acionado, um alerta por e-mail é enviado a todos os administradores da conta de faturamento e proprietários do projeto com detalhes sobre como remover o limite. Você também verá banners na UI do console de faturamento, na página "Orçamentos" e na página de visão geral do faturamento.

Redefinição automática de orçamentos com gasto máximo

No início do próximo período de orçamento (normalmente o primeiro dia do próximo mês), todos os orçamentos de limite de gastos são redefinidos automaticamente, definindo o valor de gasto bruto estimado como zero e o status do limite de gastos como Configurado.

Se um gasto máximo foi aplicado no período de orçamento anterior, o serviço especificado é desbloqueado e a função normal é restaurada.

Serviços qualificados para orçamentos com gasto máximo

Os gastos máximos estão disponíveis para os seguintes serviços baseados em API:

Serviço ID do serviço Nome do serviço da API
API Gemini AEFD-7695-64FA generativelanguage.googleapis.com
Gemini Enterprise Agent Platform (antiga Vertex AI) C7E2-9256-1C43 aiplatform.googleapis.com
Cloud Run 152E-C115-5142 run.googleapis.com
Cloud Run functions 29E7-DA93-CA13 cloudfunctions.googleapis.com

Limitações dos orçamentos com gasto máximo

Os orçamentos com gasto máximo estão sujeitos às seguintes limitações:

  • Os gastos máximos são restritos a orçamentos com escopo de um único Google Cloud projeto e um único serviço qualificado dentro do projeto especificado.
  • O período do orçamento de gasto máximo é limitado a Mensal, começando no primeiro dia de cada mês (por exemplo, 1º de maio).
  • Os cálculos de custo para gastos máximos são baseados em custos brutos e estimados e não incluem economias e créditos.
  • Pastas, organizações, rótulos e orçamentos de vários projetos ou serviços estão fora do escopo.
  • Os orçamentos de gasto máximo são restritos a clientes próprios do Google Cloud . As contas de revendedor estão fora do escopo.
  • Os gastos máximos se aplicam ao uso on demand, de pagamento por uso e ao uso coberto por compromissos, como descontos por compromisso de uso (CUDs). Os custos baseados em assinatura (como as assinaturas do Gemini Enterprise) estão fora do escopo.

  • Aplicação mais rápida, relatórios atrasados: como os limites de gastos são aplicados usando custos brutos e estimados, os alertas e limites são acionados muito mais rápido do que os custos reais que aparecem nos relatórios de faturamento. Devido à complexidade dos nossos sistemas de faturamento e processamento, os detalhes do custo real geralmente ficam disponíveis em um dia, mas às vezes podem levar mais de 24 horas para serem processados e aparecerem nos relatórios de faturamento.

Permissões necessárias para gerenciar orçamentos com gasto máximo

Para configurar, editar e remover orçamentos com gasto máximo, você precisa de permissões específicas que permitam acessar uma conta do Cloud Billing, visualizar e criar orçamentos e configurar orçamentos com gasto máximo. As permissões necessárias variam dependendo se você gerencia orçamentos e gastos máximos no nível da conta de faturamento (usando permissões completas da conta de faturamento) ou no nível do projeto (usando permissões de faturamento com escopo do projeto).

Se você estiver usando papéis personalizados para conceder permissões de gerenciamento de orçamentos, atualize-os para incluir estas permissões de gerenciamento de orçamentos com gasto máximo:

  • Nível da conta de faturamento: billing.budgets.configureSpendCap na conta do Cloud Billing.

  • Nível do projeto: billing.resourcebudgets.configureSpendCap no projeto.

Permissões completas da conta de faturamento

As permissões da conta do Cloud Billing são concedidas usando papéis na conta de faturamento. Para gerenciar orçamentos só para alertas e de gasto máximo na sua conta do Cloud Billing, é necessário ter um papel na conta do Cloud Billing que inclua todas as seguintes permissões:

Para receber essas permissões usando um papel predefinido, peça ao administrador para conceder o seguinte papel do Cloud Billing IAM na sua conta do Cloud Billing:

Também é possível usar uma combinação de papéis de conta de faturamento e de projeto para receber as permissões necessárias para gerenciar orçamentos com gasto máximo:

Permissões de faturamento com escopo de projeto

Ao usar permissões específicas de faturamento em um projeto, é possível gerenciar orçamentos para os projetos que você possui, um de cada vez.

Para mais informações sobre permissões limitadas ao projeto para gerenciar orçamentos e alertas em contas do Cloud Billing, consulte acesso com escopo de projeto a contas do Cloud Billing.

Acessar uma conta de faturamento para vários projetos do Google Cloud Acessar o faturamento de um projeto individual do Google Cloud

É possível gerenciar os orçamentos dos seus projetos autorizados do Google Cloud , um por vez.

Quando você tem acesso com escopo de vários projetos a uma conta do Cloud Billing por meio de uma combinação de permissões de projeto e de conta de faturamento, na página "Orçamentos", é possível usar um seletor de projetos para alternar entre os projetos autorizados para faturamento.

  • Projetos: você precisa de permissões específicas de faturamento em cada projeto do Google Cloud . As permissões do projeto são concedidas com papéis no projeto ou na pasta doGoogle Cloud .

    Para gerenciar orçamentos com gasto máximo, você precisa, no mínimo, das seguintes permissões em cada projeto:

    • resourcemanager.projects.get
    • billing.resourceCosts.get (opcional)*.
    • billing.resourcebudgets.read
    • billing.resourcebudgets.write
    • billing.resourcebudgets.configureSpendCap
  • Conta do Cloud Billing: você precisa de permissões de faturamento com escopo de projeto na conta do Cloud Billing que está vinculada aos seus projetos autorizados. Você concede permissões de conta de faturamento usando papéis do IAM na conta do Cloud Billing.

    Para acesso com escopo de vários projetos à conta de faturamento (pré-lançamento), você precisa do seguinte papel na conta do Cloud Billing:

Saiba mais sobre as permissões necessárias para o acesso com escopo de vários projetos às contas do Cloud Billing.

Para acessar o Cloud Billing e gerenciar orçamentos de um projeto individual do Google Cloud , um projeto por vez, você só precisa de permissões específicas de faturamento no projeto doGoogle Cloud .

  • Projetos: você precisa de permissões de visualização de custos específicas de faturamento em cada projeto do Google Cloud em que quer gerenciar orçamentos e alertas. As permissões do projeto são concedidas com papéis no projeto ou na pasta doGoogle Cloud .

    Para gerenciar orçamentos com gasto máximo, você precisa, no mínimo, das seguintes permissões em cada projeto:

    • resourcemanager.projects.get
    • billing.resourceCosts.get (opcional)*.
    • billing.resourcebudgets.read
    • billing.resourcebudgets.write
    • billing.resourcebudgets.configureSpendCap
  • As permissões da conta do Cloud Billing não são necessárias: se você estiver visualizando as informações de faturamento de um projeto por vez, não precisará de permissões na conta do Cloud Billing que está vinculada ao seu projeto autorizado do Google Cloud .

Saiba mais sobre as permissões de projeto necessárias para o acesso com escopo de projeto único às contas do Cloud Billing.

Configurar um orçamento de gasto máximo

Siga estas etapas para criar um orçamento com gasto máximo:

  1. No console do Google Cloud , acesse a página Orçamentos e alertas usando o procedimento adequado ao seu nível de acesso às contas do Cloud Billing.

  2. Na página Orçamentos e alertas, clique em Criar novo orçamento.

Etapa 1: definir. Selecione a aplicação do limite de gastos e dê um nome ao orçamento.
1: selecione a aplicação do limite de gastos e dê um nome ao orçamento.

1. Seção Definir

  1. Selecione a opção Aplicação do limite de gastos (em vez de Somente alertas).
  2. Insira um Nome para o orçamento e clique em Próxima.
Etapa 2: escopo – selecione o projeto e o serviço para o orçamento de gasto máximo.
2: selecione o projeto e o serviço para o orçamento.

2. Seção Escopo

  1. Para orçamentos com gasto máximo, o seletor Período é definido automaticamente como Mensal. Não é possível editar essa configuração.
  2. Selecione um projeto e um serviço qualificado para o gasto máximo.

  3. Para orçamentos com gasto máximo, não é possível editar as configurações de Economia.

    • Para determinados serviços, podemos estimar os custos direcionais mais rapidamente do que podemos calcular os custos reais. Para esses serviços, o valor de gasto que usamos para aplicar um orçamento de limite de gastos é baseado em custos brutos estimados, excluindo economias.
    • Para os serviços restantes, calculamos o valor do gasto usando os custos reais, incluindo todas as economias.

  4. Clique em Próxima.

Etapa 3: valor: defina o gasto máximo.
3: defina o valor do gasto máximo.

3. Seção Valor

  1. Para orçamentos com gasto máximo, o seletor Tipo de orçamento é definido automaticamente como Valor especificado. Não é possível editar essa configuração.

  2. Insira o Valor desejado do limite de gastos.

    • Quando esse limite de gastos é atingido, o uso do serviço selecionado é pausado.
    • Devido à latência nos relatórios de uso e custo, a aplicação do gasto máximo não é instantânea. Considere definir seu orçamento um pouco abaixo do limite absoluto. Você continua responsável por todos os custos excedentes acumulados devido à latência de relatórios.

  3. Clique em Próxima.

Etapa 4: as ações são configuradas automaticamente. Selecione "Concluir" para salvar o orçamento com gasto máximo.
4: selecione "Concluir" para salvar o orçamento de gasto máximo.

4. Seção Ações

  1. As notificações de gasto máximo são configuradas automaticamente para avisar todos os administradores de faturamento e Proprietários do projeto quando 50%, 80% e 100% do valor do orçamento forem atingidos.
  2. Para orçamentos com gasto máximo, os alertas e destinatários não podem ser personalizados.
  3. Clique em Concluir para salvar e ativar o orçamento com gasto máximo.

Ver uma lista de orçamentos

Depois que os orçamentos forem criados, você poderá acessar o painel "Orçamentos" para ver uma lista de orçamentos de uma conta do Cloud Billing. Cada orçamento na lista inclui uma visão geral das configurações de orçamento e uma barra de progresso de Valor dos gastos e do orçamento, um indicador visual de como seus gastos doGoogle Cloud estão acompanhando o valor desejado do orçamento. Para orçamentos com limite de gastos, a barra de progresso mostra os custos brutos estimados, que podem ser diferentes dos custos reais.

Para entender o status dos seus orçamentos, consulte a coluna Status do gasto máximo no painel "Orçamentos". Os possíveis valores incluem:

  • Não relevante: para orçamentos somente para alertas que não acionam um gasto máximo.
  • Configurado: para orçamentos com gasto máximo que estão ativos durante o período do orçamento, mas ainda não foram aplicados.
  • Aplicado: para orçamentos com limite de gastos que são acionados durante o período do orçamento quando os custos de uso brutos e estimados excedem o valor desejado do orçamento. Quando aplicados, os serviços especificados são pausados durante o restante do período do orçamento, a menos que você suspenda manualmente o limite.

  • Removido: para orçamentos com gasto máximo que foram aplicados durante o período do orçamento e, em seguida, removidos manualmente para continuar usando os serviços que foram pausados.

    • Para um orçamento em um estado Lifted, o gasto máximo não será acionado novamente pelo restante do período do orçamento, a menos que você edite o orçamento para aumentar o valor desejado do gasto máximo.
    • Depois de remover o gasto máximo, os serviços afetados podem levar até uma hora para voltar ao funcionamento normal.
    • Depois que um gasto máximo é suspenso manualmente, no início do próximo período de orçamento, o orçamento do gasto máximo é redefinido automaticamente, definindo o valor do gasto como zero e o status do gasto máximo como Configurado.

Remover manualmente um gasto máximo aplicado

Quando um gasto máximo é acionado, o novo uso do serviço específico é bloqueado até que o gasto máximo seja removido. Você vai receber notificações por e-mail e verá banners no console de faturamento, conforme descrito na seção Como funcionam os orçamentos com gasto máximo. A remoção do limite restaura a função normal das chamadas de API.

Durante o período do orçamento em que um gasto máximo é aplicado, é possível desbloquear o uso removendo manualmente um gasto máximo aplicado. Se você não fizer nada, um gasto máximo aplicado será removido automaticamente no início do próximo período do orçamento.

Para suspender manualmente um gasto máximo, edite o orçamento em que o gasto máximo é aplicado.

Editar um orçamento para suspender um gasto máximo aplicado.
Remover um gasto máximo aplicado.

  1. No console do Google Cloud , acesse a página Orçamentos e alertas usando o procedimento adequado ao seu nível de acesso às contas do Cloud Billing.

  2. Na página Orçamentos e alertas, procure o banner informativo sobre gastos máximos e selecione Ver detalhes do gasto máximo para conferir o painel de orçamentos filtrado para mostrar os orçamentos com gasto máximo aplicados.

  3. Clique no nome do orçamento para abri-lo e editá-lo.

  4. Na página Editar orçamento, selecione Suspender limite de gastos para reativar os serviços e reiniciar o uso.

  5. Clique em Confirmar para remover o gasto máximo.

    • Se o gasto máximo foi aplicado e removido manualmente no mesmo período de orçamento, ele não será acionado novamente pelo restante do período, a menos que você edite o orçamento para aumentar o valor desejado do gasto máximo.

    • No início do próximo período de orçamento, o gasto máximo é redefinido automaticamente e será acionado novamente se os custos excederem o limite do orçamento no período atual.

Editar um orçamento com gasto máximo

É possível editar um orçamento com gasto máximo para mudar o nome do orçamento, o valor desejado, o projeto ou o serviço qualificado ou para remover manualmente um gasto máximo aplicado. Não é possível editar outras configurações de um orçamento com gasto máximo.

Importante:não é possível editar as configurações de um orçamento com gasto máximo enquanto ele está em vigor. Antes de editar as configurações de orçamento, você precisa remover manualmente o gasto máximo aplicado.

  1. Para editar um orçamento com gasto máximo, acesse o painel "Orçamentos" usando o procedimento adequado ao seu nível de acesso às contas do Cloud Billing e aos orçamentos.
  2. Na página Orçamentos e alertas, clique no nome do orçamento de gasto máximo que você quer editar. A página Editar orçamento será aberta.
  3. Na página Editar orçamento, modifique as configurações que você quer alterar e clique em Salvar.

Excluir um orçamento de gasto máximo

Importante:não é possível excluir um orçamento com gasto máximo enquanto ele estiver em vigor. Antes de excluir um orçamento com gasto máximo, você precisa suspender manualmente o gasto máximo aplicado.

  1. Para excluir um orçamento com gasto máximo, acesse o painel Orçamentos usando o procedimento adequado ao seu nível de acesso às contas do Cloud Billing e para excluir orçamentos.
  2. Na página Orçamentos e alertas, marque a caixa ao lado do nome do orçamento de gasto máximo que você quer excluir.
  3. Clique em Excluir.
  4. No prompt, confirme esta ação.

Criar e gerenciar orçamentos com gasto máximo usando uma API

Com a API Cloud Billing Budget, é possível visualizar, criar e gerenciar orçamentos de gasto máximo de maneira programática em grande escala. Isso é especialmente útil se você estiver criando um grande número de orçamentos com gasto máximo na sua organização.

Perguntas frequentes

O que são gastos máximos?

Os gastos máximos são um mecanismo de controle de custos. Um gasto máximo é aplicado quando os custos de uso excedem o valor da meta de orçamento. Quando aplicada, qualquer nova solicitação para os serviços qualificados, no projeto especificado, é pausada e nenhum custo de uso adicional é acumulado. Nenhum outro projeto ou serviço será afetado.

Os limites de gastos normalmente usam custos estimados para acionar os alertas e limites, aplicando um limite muito mais rápido do que os custos reais são processados e aparecem nos relatórios de faturamento. Embora seja mais rápida do que os relatórios, a aplicação dos gastos máximos não é instantânea, e qualquer custo excedente é faturado normalmente.

Voltar para as perguntas frequentes

Em que posso definir gastos máximos?

Na sua conta do Cloud Billing, é possível definir um limite para os orçamentos com escopo para serviços qualificados específicos em um projeto. Os orçamentos de gasto máximo só podem ser definidos em um projeto e um serviço por vez. Nesta versão, os serviços qualificados incluem a API Gemini, a Agent Platform (antiga Vertex AI), o Cloud Run e o Cloud Run functions. Outros serviços serão incluídos em versões futuras.

Voltar para as perguntas frequentes

Meus recursos ou dados serão excluídos quando um limite for acionado?

Não, os recursos ou dados não são excluídos. Somente o uso de serviços específicos é pausado quando o limite é acionado. Todos os outros serviços e projetos devem funcionar normalmente.

Voltar para as perguntas frequentes

O que acontece com minhas solicitações em andamento?

Somente o uso novo é bloqueado quando o gasto máximo é aplicado. O uso em andamento é processado até a conclusão.

Voltar para as perguntas frequentes

Como sou cobrado durante um gasto máximo?

Qualquer excedente devido à latência de relatórios de custo é faturado normalmente. Além disso, todos os custos fixos contínuos necessários para manter os serviços são faturados normalmente.

Voltar para as perguntas frequentes

Para os gastos máximos, há alguma mudança na latência de relatórios de custo?

Para determinados serviços, podemos estimar os custos direcionais mais rapidamente do que os custos reais. Para esses serviços, aplicamos o limite de gastos se os custos direcionais estimados atingirem o valor da meta de orçamento. Os custos direcionais não aparecem nos relatórios de custos. Os custos reais desses serviços são publicados em relatórios de custos, sujeitos à mesma latência de hoje. Os serviços para os quais não temos custos direcionais estimados seguem a latência normal de relatórios de custos.

Voltar para as perguntas frequentes

O que acontece se vários usuários criarem limites de gasto sobrepostos na ferramenta de orçamentos?

Temos uma política de eliminação de duplicação que impede que os usuários criem mais de um orçamento com o mesmo escopo.

Voltar para as perguntas frequentes

Qual é a diferença entre o orçamento com limite de gastos disponível no AI Studio e o console do Cloud Billing?

Os gastos máximos nos Google Cloud orçamentos oferecem a mesma proteção de gastos do AI Studio e a expandem para a plataforma de nuvem mais ampla, com cobertura de gasto máximo em outros serviços.

Além disso, os orçamentos com gasto máximo no Cloud Billing acionam alertas de gastos quando os custos acumulados atingem 50%, 80% e 100% do valor do orçamento desejado.

Voltar para as perguntas frequentes

O que acontece se um usuário criar um orçamento com limite de gastos para a API Gemini no AI Studio e no console do Cloud Billing?

Se um ou mais usuários criarem orçamentos com limite de gastos no AI Studio e no console do Cloud Billing, o orçamento que receber o custo de uso mais rapidamente será acionado primeiro. No entanto, independentemente de onde o limite é acionado, o uso da API Gemini é bloqueado para o projeto em todas as plataformas.

Voltar para as perguntas frequentes

O que acontece se um projeto com um gasto máximo for movido de uma conta de faturamento para outra?

Na conta de faturamento antiga, todos os orçamentos de gasto máximo do projeto são excluídos. Para que os gastos máximos do projeto fiquem ativos na nova conta de faturamento, eles precisam ser recriados nela. Se o projeto for movido enquanto o gasto máximo estiver em um estado de restrição, o gasto máximo será removido automaticamente, restaurando a função normal das chamadas de API que foram pausadas e permitindo que novas cobranças sejam acumuladas.

Voltar para as perguntas frequentes