Presupuestos de Microsoft.Consumption

Definición de recursos de Bicep

El tipo de recurso de presupuestos se puede implementar con operaciones destinadas a:

• Inquilino - Ver comandos de despliegue de tenant Grupos* de gestión - Ver comandos de despliegue de grupo de* - Ver comandos de despliegue de suscripciónGrupos de recursos - Ver *

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Ejemplos de uso

Ejemplos de Bicep

Un ejemplo básico de implementación del presupuesto de consumo.

targetScope = 'subscription'

param resourceName string = 'acctest0001'
param location string = 'westus'

resource resourceGroup 'Microsoft.Resources/resourceGroups@2020-06-01' = {
  name: resourceName
  location: location
}

resource budget 'Microsoft.Consumption/budgets@2019-10-01' = {
  name: resourceName
  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'
    }
  }
}

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Formato de recurso

Para crear un recurso Microsoft.Consumption/budgets, agregue el siguiente bicep a la plantilla.

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 propiedad

Microsoft.Consumo/presupuestos

BudgetComparisonExpression

Filtro de presupuesto

BudgetFilterProperties

BudgetProperties

BudgetPropertiesNotifications

BudgetTimePeriod

Notificación

Definición de recursos de plantilla de ARM

El tipo de recurso de presupuestos se puede implementar con operaciones destinadas a:

• Inquilino - Ver comandos de despliegue de inquilino Grupos* de gestión - Ver comandos de despliegue del grupo de gestión* - Ver comandos de despliegue de suscripción* - Véase comandos de despliegue de grupos de recursos Para una lista de propiedades modificadas en cada versión de API, véase registro de cambios.

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Plantilla	Descripción
Crear un de presupuesto	Esta plantilla muestra cómo crear un presupuesto en una suscripción.
Crear un presupuesto con filtro	Esta plantilla muestra cómo crear un presupuesto en una suscripción.
Crear un de presupuesto simple	Esta plantilla muestra cómo crear un presupuesto en una suscripción.

Formato de recurso

Para crear un recurso Microsoft.Consumption/budgets, agregue el siguiente JSON a la plantilla.

{
  "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 propiedad

Microsoft.Consumo/presupuestos

BudgetComparisonExpression

Filtro de presupuesto

BudgetFilterProperties

BudgetProperties

BudgetPropertiesNotifications

BudgetTimePeriod

Notificación

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso de presupuestos se puede implementar con operaciones destinadas a:

• Inquilino* Grupos directivos* Suscripción* Grupos de recursos Para una lista de propiedades modificadas en cada versión de la API, consulte registro de cambios.

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación del presupuesto 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"
      }
    }
  }
}

Formato de recurso

Para crear un recurso Microsoft.Consumption/budgets, agregue el siguiente Terraform a la plantilla.

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 propiedad

Microsoft.Consumo/presupuestos

BudgetComparisonExpression

Filtro de presupuesto

BudgetFilterProperties

BudgetProperties

BudgetPropertiesNotifications

BudgetTimePeriod

Notificación