Budget Microsoft.Consumption

• più recenti
• 2024-08-01
• 2023-11-01
• 2023-05-01
• 2023-03-01
• 2022-09-01
• 2021-10-01
• 2021-05-01
• 2019-11-01
• 10-10-2019
• 2019-06-01
• 2019-05-01
• Anteprima 2019-05-01
• 2019-04-01-preview
• 2019-01-01
• 2018-10-01
• 2018-08-31
• 2018-06-30
• 2018-03-31
• 2018-01-31
• Anteprima 2017-12-30

Definizione di risorsa Bicep

Il tipo di risorsa budget può essere distribuito con operazioni destinate a:

• Tenant - Vedi comandi di deployment tenant Gruppi* di gestione - Vedi comandi* deployment gruppo di gestioneAbbonamento - Vedi comandi* deployment in abbonamentoGruppi di risorse - Vedi comandi deployment gruppo risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Esempi di utilizzo

Esempi bicep

Un esempio di base di distribuzione del budget di 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'
    }
  }
}

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo	Descrizione
budget a consumo	Modulo risorse AVM per budget a consumo
Budget dei Consumi - Ambito del Gruppo di Gestione	AVM Child Module per il Budget dei Consumi - Ambito del Gruppo di Gestione
Budget di Consumo - Ambito dei Gruppi di Risorse	AVM Child Module per il Budget di Consumo - Ambito del Gruppo di Risorse
Budget di Consumo - Ambito dell'Abbonamento	Modulo AVM Child per il Budget di Consumo - Ambito dell'Abbonamento

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

File bicipite	Descrizione
Creare un di budget	Questo modello illustra come creare un budget in una sottoscrizione.
Creare un budget con di filtro	Questo modello illustra come creare un budget in una sottoscrizione.
Creare un di budget semplice	Questo modello illustra come creare un budget in una sottoscrizione.

Formato risorsa

Per creare una risorsa Microsoft.Consumption/budget, aggiungere il bicep seguente al modello.

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

Valori delle proprietà

Microsoft.Consumption/budget

Nome	Descrizione	Valore
eTag	eTag della risorsa. Per gestire lo scenario di aggiornamento simultaneo, questo campo verrà usato per determinare se l'utente sta aggiornando o meno la versione più recente.	corda
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	Proprietà del budget.	Proprietà del bilancio
portata	Usare quando si crea una risorsa in un ambito diverso dall'ambito di distribuzione.	Impostare questa proprietà sul nome simbolico di una risorsa per applicare la risorsa di estensione .

BudgetComparisonExpression

Nome	Descrizione	Valore
nome	Nome della colonna da utilizzare in confronto.	stringa (obbligatorio)
operatore	Operatore da utilizzare per il confronto.	'In' (obbligatorio)
valori	Matrice di valori da usare per il confronto	string[] (obbligatorio)

BudgetFilter

Nome	Descrizione	Valore
e	Espressione logica "AND". Deve contenere almeno 2 elementi.	BudgetFilterProperties []
dimensioni	Espressione di confronto per una dimensione	BudgetComparisonExpression
Tag	Ha un'espressione di confronto per un tag	BudgetComparisonExpression

Proprietà BudgetFilterBudget

Nome	Descrizione	Valore
dimensioni	Espressione di confronto per una dimensione	BudgetComparisonExpression
Tag	Ha un'espressione di confronto per un tag	BudgetComparisonExpression

Proprietà del bilancio

Nome	Descrizione	Valore
importo	Importo totale dei costi da tenere traccia del budget	int (obbligatorio)
categoria	Categoria del budget, indipendentemente dal fatto che il budget tenga traccia dei costi o dell'utilizzo.	'Cost' (obbligatorio)
filtro	Può essere usato per filtrare i budget in base alle dimensioni e/o ai tag specificati dall'utente.	BudgetFilter
Notifiche	Dizionario delle notifiche associate al budget. Il budget può avere fino a cinque notifiche.	BudgetProprietàNotifiche
timeGrain	Tempo coperto da un budget. Il rilevamento della quantità verrà reimpostato in base all'intervallo di tempo. BillingMonth, BillingQuarter e BillingAnnual sono supportati solo dai clienti WD	'Annualmente' 'Fatturazione annuale' 'Mese di fatturazione' 'BillingQuarter' 'Mensile' 'Trimestrale' (obbligatorio)
timePeriod	Data di inizio e fine del budget. La data di inizio deve essere prima del mese e deve essere minore della data di fine. La data di inizio del budget deve essere attiva o successiva al 1° giugno 2017. La data di inizio futura non deve essere superiore a dodici mesi. La data di inizio precedente deve essere selezionata entro il periodo di tempo. Non sono previste restrizioni per la data di fine.	BudgetTimePeriod (obbligatorio)

BudgetProprietàNotifiche

Nome	Descrizione	Valore

BudgetTimePeriod

Nome	Descrizione	Valore
Data di fine	Data di fine del budget. Se non specificato, per impostazione predefinita viene impostato su 10 anni dalla data di inizio.	corda
data di inizio	Data di inizio del budget.	stringa (obbligatorio)

Notifica

Nome	Descrizione	Valore
contattoE-mail	Indirizzi di posta elettronica a cui inviare la notifica del budget quando viene superata la soglia. Deve avere almeno un indirizzo di posta elettronica di contatto o un gruppo di contatti specificato negli ambiti sottoscrizione o gruppo di risorse. Tutti gli altri ambiti devono avere almeno un messaggio di posta elettronica di contatto specificato.	string[] (obbligatorio)
contattoGruppi	Gruppi di azioni a cui inviare la notifica del budget quando viene superata la soglia. Deve essere fornito come ID risorsa di Azure completo. Supportato solo in ambiti sottoscrizione o gruppo di risorse.	stringa[]
contactRoles	Contattare i ruoli per inviare la notifica del budget a quando viene superata la soglia.	stringa[]
Abilitato	La notifica è abilitata o meno.	bool (obbligatorio)
scena	Lingua in cui il destinatario riceverà la notifica	'cs-cz' 'da-dk' 'de-de' 'en-gb' 'en-us' 'es-es' 'fr-fr' 'hu-hu' 'it-it' 'ja-jp' 'ko-kr' 'nb-no' 'nl-nl' 'pl-pl' 'pt-br' 'pt-pt' 'ru-ru' 'sv-se' 'tr-tr' 'zh-cn' 'zh-tw'
operatore	Operatore di confronto.	'Uguale a' 'Più grande di' 'GreaterThanOrEqualTo' (obbligatorio)
soglia	Valore soglia associato a una notifica. La notifica viene inviata quando il costo supera la soglia. È sempre la percentuale e deve essere compresa tra 0 e 1000.	int (obbligatorio)
thresholdType	Tipo di soglia	'Effettivo' 'Previsionale'

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa budget può essere distribuito con operazioni destinate a:

• Tenant - Vedi comandi di deployment tenant Gruppi* di gestione - Vedi comandi* di deployment gruppo digestione Abbonamento - Vedi comandi* deployment in abbonamentoGruppi di risorse - Vedi comandi deployment del gruppo risorse Per un elenco delle proprietà modificate in ciascuna versione dell'API, vedi registro modifiche.

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Sagoma	Descrizione
Creare un di budget	Questo modello illustra come creare un budget in una sottoscrizione.
Creare un budget con di filtro	Questo modello illustra come creare un budget in una sottoscrizione.
Creare un di budget semplice	Questo modello illustra come creare un budget in una sottoscrizione.

Formato risorsa

Per creare una risorsa Microsoft.Consumption/budget, aggiungere il codice JSON seguente al modello.

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

Valori delle proprietà

Microsoft.Consumption/budget

Nome	Descrizione	Valore
versione dell'API	Versione dell'API	'2024-08-01'
eTag	eTag della risorsa. Per gestire lo scenario di aggiornamento simultaneo, questo campo verrà usato per determinare se l'utente sta aggiornando o meno la versione più recente.	corda
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	Proprietà del budget.	Proprietà del bilancio
digitare	Tipo di risorsa	'Microsoft.Consumption/budget'

BudgetComparisonExpression

Nome	Descrizione	Valore
nome	Nome della colonna da utilizzare in confronto.	stringa (obbligatorio)
operatore	Operatore da utilizzare per il confronto.	'In' (obbligatorio)
valori	Matrice di valori da usare per il confronto	string[] (obbligatorio)

BudgetFilter

Nome	Descrizione	Valore
e	Espressione logica "AND". Deve contenere almeno 2 elementi.	BudgetFilterProperties []
dimensioni	Espressione di confronto per una dimensione	BudgetComparisonExpression
Tag	Ha un'espressione di confronto per un tag	BudgetComparisonExpression

Proprietà BudgetFilterBudget

Nome	Descrizione	Valore
dimensioni	Espressione di confronto per una dimensione	BudgetComparisonExpression
Tag	Ha un'espressione di confronto per un tag	BudgetComparisonExpression

Proprietà del bilancio

Nome	Descrizione	Valore
importo	Importo totale dei costi da tenere traccia del budget	int (obbligatorio)
categoria	Categoria del budget, indipendentemente dal fatto che il budget tenga traccia dei costi o dell'utilizzo.	'Cost' (obbligatorio)
filtro	Può essere usato per filtrare i budget in base alle dimensioni e/o ai tag specificati dall'utente.	BudgetFilter
Notifiche	Dizionario delle notifiche associate al budget. Il budget può avere fino a cinque notifiche.	BudgetProprietàNotifiche
timeGrain	Tempo coperto da un budget. Il rilevamento della quantità verrà reimpostato in base all'intervallo di tempo. BillingMonth, BillingQuarter e BillingAnnual sono supportati solo dai clienti WD	'Annualmente' 'Fatturazione annuale' 'Mese di fatturazione' 'BillingQuarter' 'Mensile' 'Trimestrale' (obbligatorio)
timePeriod	Data di inizio e fine del budget. La data di inizio deve essere prima del mese e deve essere minore della data di fine. La data di inizio del budget deve essere attiva o successiva al 1° giugno 2017. La data di inizio futura non deve essere superiore a dodici mesi. La data di inizio precedente deve essere selezionata entro il periodo di tempo. Non sono previste restrizioni per la data di fine.	BudgetTimePeriod (obbligatorio)

BudgetProprietàNotifiche

Nome	Descrizione	Valore

BudgetTimePeriod

Nome	Descrizione	Valore
Data di fine	Data di fine del budget. Se non specificato, per impostazione predefinita viene impostato su 10 anni dalla data di inizio.	corda
data di inizio	Data di inizio del budget.	stringa (obbligatorio)

Notifica

Nome	Descrizione	Valore
contattoE-mail	Indirizzi di posta elettronica a cui inviare la notifica del budget quando viene superata la soglia. Deve avere almeno un indirizzo di posta elettronica di contatto o un gruppo di contatti specificato negli ambiti sottoscrizione o gruppo di risorse. Tutti gli altri ambiti devono avere almeno un messaggio di posta elettronica di contatto specificato.	string[] (obbligatorio)
contattoGruppi	Gruppi di azioni a cui inviare la notifica del budget quando viene superata la soglia. Deve essere fornito come ID risorsa di Azure completo. Supportato solo in ambiti sottoscrizione o gruppo di risorse.	stringa[]
contactRoles	Contattare i ruoli per inviare la notifica del budget a quando viene superata la soglia.	stringa[]
Abilitato	La notifica è abilitata o meno.	bool (obbligatorio)
scena	Lingua in cui il destinatario riceverà la notifica	'cs-cz' 'da-dk' 'de-de' 'en-gb' 'en-us' 'es-es' 'fr-fr' 'hu-hu' 'it-it' 'ja-jp' 'ko-kr' 'nb-no' 'nl-nl' 'pl-pl' 'pt-br' 'pt-pt' 'ru-ru' 'sv-se' 'tr-tr' 'zh-cn' 'zh-tw'
operatore	Operatore di confronto.	'Uguale a' 'Più grande di' 'GreaterThanOrEqualTo' (obbligatorio)
soglia	Valore soglia associato a una notifica. La notifica viene inviata quando il costo supera la soglia. È sempre la percentuale e deve essere compresa tra 0 e 1000.	int (obbligatorio)
thresholdType	Tipo di soglia	'Effettivo' 'Previsionale'

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa budget può essere distribuito con operazioni destinate a:

• Inquilino* Gruppi * Abbonamento* Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Esempi di utilizzo

Esempi di Terraform

Un esempio di base di distribuzione del budget di 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 risorsa

Per creare una risorsa Microsoft.Consumption/budget, aggiungere il modello Terraform seguente.

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

Valori delle proprietà

Microsoft.Consumption/budget

Nome	Descrizione	Valore
eTag	eTag della risorsa. Per gestire lo scenario di aggiornamento simultaneo, questo campo verrà usato per determinare se l'utente sta aggiornando o meno la versione più recente.	corda
nome	Nome della risorsa	stringa (obbligatorio)
parent_id	ID della risorsa a cui applicare la risorsa di estensione.	stringa (obbligatorio)
proprietà	Proprietà del budget.	Proprietà del bilancio
digitare	Tipo di risorsa	"Microsoft.Consumption/budgets@2024-08-01"

BudgetComparisonExpression

Nome	Descrizione	Valore
nome	Nome della colonna da utilizzare in confronto.	stringa (obbligatorio)
operatore	Operatore da utilizzare per il confronto.	'In' (obbligatorio)
valori	Matrice di valori da usare per il confronto	string[] (obbligatorio)

BudgetFilter

Nome	Descrizione	Valore
e	Espressione logica "AND". Deve contenere almeno 2 elementi.	BudgetFilterProperties []
dimensioni	Espressione di confronto per una dimensione	BudgetComparisonExpression
Tag	Ha un'espressione di confronto per un tag	BudgetComparisonExpression

Proprietà BudgetFilterBudget

Nome	Descrizione	Valore
dimensioni	Espressione di confronto per una dimensione	BudgetComparisonExpression
Tag	Ha un'espressione di confronto per un tag	BudgetComparisonExpression

Proprietà del bilancio

Nome	Descrizione	Valore
importo	Importo totale dei costi da tenere traccia del budget	int (obbligatorio)
categoria	Categoria del budget, indipendentemente dal fatto che il budget tenga traccia dei costi o dell'utilizzo.	'Cost' (obbligatorio)
filtro	Può essere usato per filtrare i budget in base alle dimensioni e/o ai tag specificati dall'utente.	BudgetFilter
Notifiche	Dizionario delle notifiche associate al budget. Il budget può avere fino a cinque notifiche.	BudgetProprietàNotifiche
timeGrain	Tempo coperto da un budget. Il rilevamento della quantità verrà reimpostato in base all'intervallo di tempo. BillingMonth, BillingQuarter e BillingAnnual sono supportati solo dai clienti WD	'Annualmente' 'Fatturazione annuale' 'Mese di fatturazione' 'BillingQuarter' 'Mensile' 'Trimestrale' (obbligatorio)
timePeriod	Data di inizio e fine del budget. La data di inizio deve essere prima del mese e deve essere minore della data di fine. La data di inizio del budget deve essere attiva o successiva al 1° giugno 2017. La data di inizio futura non deve essere superiore a dodici mesi. La data di inizio precedente deve essere selezionata entro il periodo di tempo. Non sono previste restrizioni per la data di fine.	BudgetTimePeriod (obbligatorio)

BudgetProprietàNotifiche

Nome	Descrizione	Valore

BudgetTimePeriod

Nome	Descrizione	Valore
Data di fine	Data di fine del budget. Se non specificato, per impostazione predefinita viene impostato su 10 anni dalla data di inizio.	corda
data di inizio	Data di inizio del budget.	stringa (obbligatorio)

Notifica

Nome	Descrizione	Valore
contattoE-mail	Indirizzi di posta elettronica a cui inviare la notifica del budget quando viene superata la soglia. Deve avere almeno un indirizzo di posta elettronica di contatto o un gruppo di contatti specificato negli ambiti sottoscrizione o gruppo di risorse. Tutti gli altri ambiti devono avere almeno un messaggio di posta elettronica di contatto specificato.	string[] (obbligatorio)
contattoGruppi	Gruppi di azioni a cui inviare la notifica del budget quando viene superata la soglia. Deve essere fornito come ID risorsa di Azure completo. Supportato solo in ambiti sottoscrizione o gruppo di risorse.	stringa[]
contactRoles	Contattare i ruoli per inviare la notifica del budget a quando viene superata la soglia.	stringa[]
Abilitato	La notifica è abilitata o meno.	bool (obbligatorio)
scena	Lingua in cui il destinatario riceverà la notifica	'cs-cz' 'da-dk' 'de-de' 'en-gb' 'en-us' 'es-es' 'fr-fr' 'hu-hu' 'it-it' 'ja-jp' 'ko-kr' 'nb-no' 'nl-nl' 'pl-pl' 'pt-br' 'pt-pt' 'ru-ru' 'sv-se' 'tr-tr' 'zh-cn' 'zh-tw'
operatore	Operatore di confronto.	'Uguale a' 'Più grande di' 'GreaterThanOrEqualTo' (obbligatorio)
soglia	Valore soglia associato a una notifica. La notifica viene inviata quando il costo supera la soglia. È sempre la percentuale e deve essere compresa tra 0 e 1000.	int (obbligatorio)
thresholdType	Tipo di soglia	'Effettivo' 'Previsionale'