Gerenciar os custos com a automação

Você pode usar a automação de Gerenciamento de Custos para criar um conjunto personalizado de soluções para recuperar e gerenciar dados de custo. Este artigo aborda cenários comuns de automação de Gerenciamento de Custos e opções disponíveis com base em sua situação. Se você quiser desenvolver usando APIs, exemplos comuns de solicitação de API são apresentados para ajudar a acelerar seu processo de desenvolvimento.

Automatizar a recuperação de dados de custo para análise offline

Talvez seja necessário baixar os dados de custo do Azure para mesclá-los a outros conjuntos de dados. Ou talvez seja necessário integrar os dados de custo a seus próprios sistemas. Há opções diferentes disponíveis, dependendo da quantidade de dados envolvidos. Você deve ter permissões de Gerenciamento de Custos no escopo apropriado para usar APIs e ferramentas em qualquer caso. Para obter mais informações, confira Atribuir acesso a dados.

Sugestões para lidar com grandes conjuntos de dados

Se sua organização tiver uma grande presença do Azure em muitos recursos ou assinaturas, você terá um grande número de resultados de dados de detalhes de uso. O Excel geralmente não pode carregar arquivos grandes. Nessa situação, recomendamos as seguintes opções:

Power BI

O Power BI é usado para ingerir e lidar com grandes quantidades de dados. Se você for um cliente de Contrato Enterprise, poderá usar o aplicativo de modelo do Power BI para analisar os custos da conta de cobrança. O relatório contém as exibições de chave usadas pelos clientes. Para obter mais informações, confira Analisar os custos do Azure com o aplicativo de modelo do Power BI.

Conector de dados do Power BI

Se você quiser analisar seus dados diariamente, é recomendável usar o conector de dados do Power BI para obter dados para análise detalhada. O conector mantém os relatórios atualizados à medida que os custos aumentam.

Exportações de Gerenciamento de Custos

Talvez você não precise analisar os dados diariamente. Nesse caso, considere usar o recurso Exportações do Gerenciamento de Custos para agendar exportações de dados para uma conta de Armazenamento do Azure. Em seguida, você poderá carregar os dados para o Power BI conforme necessário ou analisá-los no Excel, se o arquivo for pequeno o suficiente. As exportações estão disponíveis no portal do Azure ou você pode configurar exportações com a API de Exportações.

API de Detalhes de Custo

Considere usar a API de Detalhes de Custo se você tiver um pequeno conjunto de dados de custo. Aqui estão as melhores práticas recomendadas:

Se você quiser obter os dados de custo mais recentes, recomendamos que você consulte no máximo uma vez por dia. Os relatórios são atualizados a cada quatro horas. Se você chamar com mais frequência, receberá dados idênticos.
Depois de fazer o download dos seus dados de custo referentes a faturas históricas, não se espera que as cobranças sejam alteradas, a menos que você seja explicitamente notificado. Recomendamos armazenar em cache seus dados de custo em um repositório que pode ser consultado para evitar chamadas repetidas para dados idênticos.
Divida suas chamadas em intervalos de datas pequenos para obter arquivos mais gerenciáveis que você pode baixar. Por exemplo, recomendamos o agrupamento por dia ou por semana se você tiver grandes arquivos de uso do Azure mês a mês.
Se você tiver escopos com uma grande quantidade de dados de custo (por exemplo, uma conta de cobrança), considere colocar várias chamadas para escopos filho para obter arquivos mais gerenciáveis que você pode baixar.
Se seu conjunto de informações tiver mais de 2 GB de mês para mês, considere o uso de exportações como uma solução mais escalonável.

Automatize a recuperação com a API de Detalhes de Custos

A API de Detalhes de Custo permite que você gere e baixe dados de custo detalhados e não agregados para sua conta de cobrança do Contrato Enterprise (EA) ou do MCA (Contrato de Cliente da Microsoft). Ao contrário da API de Detalhes de Uso herdada, a API de Detalhes de Custo é assíncrona e baseada em relatório: você envia uma solicitação para gerar um relatório, sondagem para sua conclusão e, em seguida, baixa o arquivo resultante de uma URL segura.

Importante

A API de Detalhes de Custo só tem suporte para escopos de Contrato Enterprise (EA) ou MCA (Contrato de Cliente da Microsoft). Para outros tipos de conta, sugerimos o uso de Exportações. Se você precisar baixar conjuntos de dados pequenos e não quiser usar o Armazenamento do Microsoft Azure, use também a API de Detalhes de Uso de Consumo. Veja instruções sobre como fazer isso aqui

Como funciona a API de Detalhes de Custo

Criar um relatório: envie uma solicitação POST para a API de Detalhes de Custo especificando o escopo, o intervalo de datas e os filtros opcionais (como medidor, recurso ou marca).
Sondagem para status: a API retorna uma ID da operação. Sonde o ponto de extremidade de status da operação até que o relatório seja concluído.
Baixe o relatório: depois que o relatório estiver pronto, a API fornecerá uma URL de download segura para o arquivo CSV que contém seus dados de custo. O link de download é válido por um tempo limitado.

Para obter detalhes completos, consulte Obter pequenos conjuntos de dados de uso sob demanda e a referência da API de Detalhes de Custo.

Exemplo: gerar e baixar um relatório de Detalhes do Custo

Para recuperar detalhes de custo usando a API de Detalhes de Custo, siga estas etapas:

Etapa 1: Criar um relatório

Envie uma solicitação POST para iniciar a geração de relatórios. Substitua {scope} por sua conta de cobrança ou escopo de perfil.

POST https://management.azure.com/{scope}/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2025-03-01
Content-Type: application/json

{
  "metric": "ActualCost",
  "timePeriod": {
    "start": "2025-03-01",
    "end": "2025-03-15"
  }
}

A resposta inclui um Location cabeçalho na resposta que contém o link de sondagem a ser usado na etapa 2.

Etapa 2: Consultar o status

Verifique o status da geração de relatório usando o link de sondagem:

GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/generateCostDetailsReport/{operationId}?api-version=2025-03-01

Quando o relatório estiver pronto, a resposta inclui a propriedade blobLink.

Etapa 3: Baixar o relatório

Use o blobLink para baixar o arquivo CSV que contém seus detalhes de custo.

Observação

A API de Detalhes de Custo é assíncrona. Você não pode recuperar detalhes de custo diretamente com uma solicitação GET para /generateCostDetailsReport. Sempre use o fluxo de trabalho de geração de relatório descrito acima. Para obter mais informações, consulte a documentação da API de Detalhes do Custo.

Práticas recomendadas para usar a API de Detalhes de Custo

Frequência de solicitação: recomendamos que os relatórios sejam gerados no máximo uma vez por dia para um determinado intervalo de escopo e data. Os dados de custo são atualizados a cada quatro horas, mas solicitações mais frequentes retornam os mesmos dados e podem ser restritas.
Intervalo de datas: para grandes conjuntos de dados, limite o intervalo de datas (por exemplo, gerar relatórios diários ou semanais) para manter os tamanhos de arquivo gerenciáveis.
Escopo: use o escopo de nível mais alto disponível (como conta de cobrança ou perfil de cobrança) para minimizar o número de chamadas à API e garantir a integridade dos dados.
Retenção de dados: baixe e armazene relatórios prontamente. A URL de download expira após um curto período (normalmente uma hora).

Anotações sobre preços e dados

A API de Detalhes de Custo fornece dados de custo reais e amortizados, incluindo todo o uso, compras e reembolsos para o período selecionado.
Os dados não são agregados e são adequados para análise detalhada, reconciliação e integração com outros sistemas.
Para obter mais informações sobre o comportamento de preços, consulte o comportamento de preços nos detalhes de custo.

Um só recurso pode ter vários registros para um só dia

Os provedores de recursos do Azure podem emitir o uso e os encargos para o sistema de cobrança com atributos diferentes (como o local do datacenter), resultando em vários registros para um recurso em um único dia. Esse comportamento é esperado e não indica sobrecarga; todos os registros juntos representam o custo total desse recurso e do dia.

Automatizar alertas e ações com orçamentos

Há dois componentes críticos para maximizar o valor do seu investimento na nuvem. Um deles é a criação automática de orçamento. O outro é a configuração da orquestração baseada em custo em resposta aos alertas de orçamento. Há diferentes maneiras de automatizar a criação de orçamentos. Várias respostas de alerta ocorrem quando os limites de alerta configurados são excedidos.

As seções a seguir abordam as opções disponíveis e fornecem exemplos de solicitações de API para você começar a usar a automação de orçamento.

Como os custos são avaliados em relação ao limite de orçamento

Seus custos são avaliados em relação ao limite de orçamento uma vez por dia. Quando você cria um orçamento ou no dia de redefinição do orçamento, os custos comparados com o limite são zero/nulos, pois a avaliação pode não ter ocorrido.

Quando o Azure detecta que os custos excederam o limite, uma notificação é disparada dentro da hora do período de detecção.

Ver os custos atuais

Para ver os custos atuais, você precisa fazer uma chamada GET usando a API de Consulta.

Uma chamada GET à API de Orçamentos não retornará os custos atuais mostrados na análise de custo. Em vez disso, a chamada retorna o último custo avaliado.

Automatizar a criação de orçamento

Você pode automatizar a criação de orçamento usando a API de Orçamentos. Você também pode criar um orçamento com um modelo de orçamento. Os modelos são uma forma fácil de padronizar as implantações do Azure, garantindo que o controle de custos seja configurado e imposto corretamente.

Localidades com suporte para alertas de orçamento por email

Com os Orçamentos, você recebe um alerta quando os custos ultrapassam um limite definido. É possível configurar até cinco destinatários de email por orçamento. Eles recebem os alertas por email nas 24 horas seguintes ao estouro do limite de orçamento. No entanto, talvez o destinatário precise receber um email em um idioma diferente. Use os códigos de cultura do idioma a seguir com a API de Orçamentos. Defina o código de cultura com o parâmetro locale, como no exemplo a seguir.

{
  "eTag": "\"1d681a8fc67f77a\"",
  "properties": {
    "timePeriod": {
      "startDate": "2020-07-24T00:00:00Z",
      "endDate": "2022-07-23T00:00:00Z"
    },
    "timeGrain": "BillingMonth",
    "amount": 1,
    "currentSpend": {
      "amount": 0,
      "unit": "USD"
    },
    "category": "Cost",
    "notifications": {
      "actual_GreaterThan_10_Percent": {
        "enabled": true,
        "operator": "GreaterThan",
        "threshold": 20,
        "locale": "en-us",
        "contactEmails": [
          "user@contoso.com"
        ],
        "contactRoles": [],
        "contactGroups": [],
        "thresholdType": "Actual"
      }
    }
  }
}

Idiomas compatíveis com um código de cultura:

Código de cultura	Linguagem
pt-br	Inglês (Estados Unidos)
ja-jp	Japonês (Japão)
ZH-CN	Chinês Simplificado (China)
de-de	Alemão (Alemanha)
es-es	Espanhol (Espanha, Internacional)
fr-fr	Francês (França)
it-it	Italiano (Itália)
ko-kr	Coreano (Coreia do Sul)
pt-br	Português (Brasil)
ru-ru	Russo (Rússia)
zh-tw	Chinês (Tradicional, Taiwan)
cs-cz	Tcheco (República Tcheca)
pl-pl	Polonês (Polônia)
tr-tr	Turco (Türkiye)
da-dk	Dinamarquês (Dinamarca)
en-gb	Inglês (Reino Unido)
hu-hu	Húngaro (Hungria)
nb-no	Norueguês Bokmal (Noruega)
nl-nl	Holandês (Países Baixos)
pt-pt	Português (Portugal)
sv-se	Sueco (Suécia)

Configurações comuns da API de Orçamentos

Há várias maneiras de configurar um orçamento no seu ambiente do Azure. Considere seu cenário primeiro e identifique as opções de configuração que o habilitam. Examine as seguintes opções:

Intervalo de agregação: representa o período recorrente usado pelo orçamento para acumular e avaliar os custos. As opções mais comuns são Mensal, Trimestral e Anual.
Período: representa por quanto tempo o orçamento será válido. O orçamento monitora e alerta você ativamente apenas enquanto ele permanece válido.
Notificações
- Emails de Contato: os endereços de email recebem alertas quando um orçamento acumula custos e excede os limites definidos.
- Funções de Contato: todos os usuários que têm uma função do Azure correspondente no escopo fornecido recebem alertas por email com essa opção. Por exemplo, os Proprietários da Assinatura podem receber um alerta para um orçamento criado no escopo da assinatura.
- Grupos de Contatos: o orçamento chama os grupos de ações configurados quando um limite de alerta é excedido.
Filtros de dimensão de custo: a mesma filtragem que você pode fazer na análise de custo ou na API de Consulta também pode ser feita no seu orçamento. Use esse filtro para reduzir o intervalo de custos que você está monitorando com o orçamento.

Depois de identificar as opções de criação de orçamento que atendem às suas necessidades, crie o orçamento usando a API. O exemplo abaixo ajuda você a começar com uma configuração comum de orçamento.

Criar um orçamento filtrado para vários recursos e várias marcas

URL da solicitação: PUT https://management.azure.com/subscriptions/{SubscriptionId} /providers/Microsoft.Consumption/budgets/{BudgetName}/?api-version=2019-10-01

{
  "eTag": "\"1d34d016a593709\"",
  "properties": {
    "category": "Cost",
    "amount": 100.65,
    "timeGrain": "Monthly",
    "timePeriod": {
      "startDate": "2017-10-01T00:00:00Z",
      "endDate": "2018-10-31T00:00:00Z"
    },
    "filter": {
      "and": [
        {
          "dimensions": {
            "name": "ResourceId",
            "operator": "In",
            "values": [
              "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{meterName}",
              "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{meterName}"
            ]
          }
        },
        {
          "tags": {
            "name": "category",
            "operator": "In",
            "values": [
              "Dev",
              "Prod"
            ]
          }
        },
        {
          "tags": {
            "name": "department",
            "operator": "In",
            "values": [
              "engineering",
              "sales"
            ]
          }
        }
      ]
    },
    "notifications": {
      "Actual_GreaterThan_80_Percent": {
        "enabled": true,
        "operator": "GreaterThan",
        "threshold": 80,
        "contactEmails": [
          "user1@contoso.com",
          "user2@contoso.com"
        ],
        "contactRoles": [
          "Contributor",
          "Reader"
        ],
        "contactGroups": [
          "/subscriptions/{subscriptionID}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}
        ],
        "thresholdType": "Actual"
      }
    }
  }
}

Configurar a orquestração baseada em custo para alertas de orçamento

Você pode configurar orçamentos para iniciar ações automatizadas usando grupos de ações do Azure. Para saber mais sobre como automatizar ações usando orçamentos, confira Automação com orçamentos.

Latência de dados e limites de taxa

Recomendamos que você chame as APIs não mais do que uma vez por dia. Os dados de gerenciamento de custos são atualizados a cada quatro horas à medida que novos dados de uso são recebidos dos provedores de recursos do Azure. Chamar com mais frequência não fornece mais dados. Em vez disso, cria uma carga maior.

Unidades de processamento de consulta da API de consulta

Além dos processos de limitação de taxa existentes, a API de consulta também limita o processamento com base no custo das chamadas à API. O custo de uma chamada à API é expresso como QPUs (unidades de processamento de consulta). A QPU é uma moeda de desempenho, como as RUs do Cosmos DB. Elas abstraem recursos do sistema, como CPU e memória.

Cálculo da QPU

Atualmente, uma QPU é deduzida para um mês de dados consultados das cotas alocadas. Essa lógica pode mudar sem aviso prévio.

Fatores da QPU

O fator a seguir afeta o número de QPUs consumidas por uma solicitação de API.

Intervalo de datas: à medida que o intervalo de datas na solicitação aumenta, o número de QPUs consumidas aumenta.

Outros fatores da QPU podem ser adicionados sem aviso prévio.

Cotas de QPU

As cotas a seguir são configuradas por locatário. As solicitações são limitadas quando qualquer uma das cotas a seguir é esgotada.

12 QPUs por 10 segundos
60 QPUs por 1 minuto
600 QPUs por 1 hora

As cotas talvez sejam alteradas conforme necessário, sendo que mais cotas podem ser adicionadas.

Cabeçalhos de resposta

Você pode examinar os cabeçalhos de resposta para acompanhar o número de QPUs consumidas por uma solicitação de API e o número de QPUs restantes.

x-ms-ratelimit-microsoft.costmanagement-qpu-retry-after

Indica o tempo de retirada em segundos. Quando uma solicitação é limitada com 429, recue pelo tempo especificado nesse cabeçalho antes de tentar a solicitação novamente.

x-ms-ratelimit-microsoft.costmanagement-qpu-consumed

QPUs consumidas por uma chamada à API.

x-ms-ratelimit-microsoft.costmanagement-qpu-remaining

Lista de cotas restantes.

Analisar os custos do Azure com o aplicativo de modelo do Power BI.
Crie e gerencie dados exportados com Exportações.
Saiba mais sobre a API de Detalhes de Custo.

Comentários

Esta página foi útil?

Last updated on 2025-07-21