Orçamentos do Microsoft.Consumption

Definição de recurso do Bicep

O tipo de recurso de orçamentos pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Consumption/budgets, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Consumption/budgets@2024-08-01' = {
  scope: resourceSymbolicName or scope
  eTag: 'string'
  name: 'string'
  properties: {
    amount: int
    category: 'string'
    filter: {
      and: [
        {
          dimensions: {
            name: 'string'
            operator: 'string'
            values: [
              'string'
            ]
          }
          tags: {
            name: 'string'
            operator: 'string'
            values: [
              'string'
            ]
          }
        }
      ]
      dimensions: {
        name: 'string'
        operator: 'string'
        values: [
          'string'
        ]
      }
      tags: {
        name: 'string'
        operator: 'string'
        values: [
          'string'
        ]
      }
    }
    notifications: {
      {customized property}: {
        contactEmails: [
          'string'
        ]
        contactGroups: [
          'string'
        ]
        contactRoles: [
          'string'
        ]
        enabled: bool
        locale: 'string'
        operator: 'string'
        threshold: int
        thresholdType: 'string'
      }
    }
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

Valores de propriedade

Microsoft.Consumption/budgets

Expressão de comparação de orçamento

Filtro de orçamento

Propriedades do Filtro de Orçamento

Propriedades do orçamento

Notificações de BudgetProperties

Período de Tempo de Orçamento

Notificação

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Definição de recurso de modelo do ARM

O tipo de recurso de orçamentos pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Consumption/budgets, adicione o JSON a seguir ao seu modelo.

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2024-08-01",
  "name": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "string",
    "filter": {
      "and": [
        {
          "dimensions": {
            "name": "string",
            "operator": "string",
            "values": [ "string" ]
          },
          "tags": {
            "name": "string",
            "operator": "string",
            "values": [ "string" ]
          }
        }
      ],
      "dimensions": {
        "name": "string",
        "operator": "string",
        "values": [ "string" ]
      },
      "tags": {
        "name": "string",
        "operator": "string",
        "values": [ "string" ]
      }
    },
    "notifications": {
      "{customized property}": {
        "contactEmails": [ "string" ],
        "contactGroups": [ "string" ],
        "contactRoles": [ "string" ],
        "enabled": "bool",
        "locale": "string",
        "operator": "string",
        "threshold": "int",
        "thresholdType": "string"
      }
    },
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

Valores de propriedade

Microsoft.Consumption/budgets

Expressão de comparação de orçamento

Filtro de orçamento

Propriedades do Filtro de Orçamento

Propriedades do orçamento

Notificações de BudgetProperties

Período de Tempo de Orçamento

Notificação

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Modelo	Descrição
criar um orçamento	Este modelo mostra como criar um orçamento em uma assinatura.
criar um orçamento com filtro	Este modelo mostra como criar um orçamento em uma assinatura.
criar um de orçamento simples	Este modelo mostra como criar um orçamento em uma assinatura.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso de orçamentos pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Consumption/budgets, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2024-08-01"
  name = "string"
  parent_id = "string"
  body = {
    eTag = "string"
    properties = {
      amount = int
      category = "string"
      filter = {
        and = [
          {
            dimensions = {
              name = "string"
              operator = "string"
              values = [
                "string"
              ]
            }
            tags = {
              name = "string"
              operator = "string"
              values = [
                "string"
              ]
            }
          }
        ]
        dimensions = {
          name = "string"
          operator = "string"
          values = [
            "string"
          ]
        }
        tags = {
          name = "string"
          operator = "string"
          values = [
            "string"
          ]
        }
      }
      notifications = {
        {customized property} = {
          contactEmails = [
            "string"
          ]
          contactGroups = [
            "string"
          ]
          contactRoles = [
            "string"
          ]
          enabled = bool
          locale = "string"
          operator = "string"
          threshold = int
          thresholdType = "string"
        }
      }
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
  }
}

Valores de propriedade

Microsoft.Consumption/budgets

Expressão de comparação de orçamento

Filtro de orçamento

Propriedades do Filtro de Orçamento

Propriedades do orçamento

Notificações de BudgetProperties

Período de Tempo de Orçamento

Notificação

Exemplos de uso

Exemplos do Terraform

Um exemplo básico de implantação do Orçamento de Consumo.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "budget" {
  type      = "Microsoft.Consumption/budgets@2019-10-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  body = {
    properties = {
      amount   = 1000
      category = "Cost"
      filter = {
        tags = {
          name     = "foo"
          operator = "In"
          values   = ["bar"]
        }
      }
      notifications = {
        "Actual_EqualTo_90.000000_Percent" = {
          contactEmails = ["foo@example.com", "bar@example.com"]
          contactGroups = []
          contactRoles  = []
          enabled       = true
          operator      = "EqualTo"
          threshold     = 90
          thresholdType = "Actual"
        }
      }
      timeGrain = "Monthly"
      timePeriod = {
        startDate = "2025-08-01T00:00:00Z"
      }
    }
  }
}