Automatizar a criação de orçamento

  • Artigo

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.

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"
      }
    }
  }
}

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 Idioma
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 (Turquia)
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)

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.

Próximas etapas