Condividi tramite

Budget Microsoft.Consumption 2019-10-01

  • Articolo

Definizione di risorsa Bicep

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

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

Formato risorsa

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

resource symbolicname 'Microsoft.Consumption/budgets@2019-10-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'
        ]
      }
      not: {
        dimensions: {
          name: 'string'
          operator: 'string'
          values: [
            'string'
          ]
        }
        tags: {
          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à

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
non Espressione logica "NOT". BudgetFilterProperties
Tag Ha un'espressione di confronto per un tag BudgetComparisonExpression

BudgetFilterProperties

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

BudgetProperties

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. BudgetPropertiesNotifications
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 'Annually'
'BillingAnnual'
'BillingMonth'
'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)

BudgetPropertiesNotifications

Nome Descrizione Valore

BudgetTimePeriod

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

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. BudgetProperties
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 .

Notifica

Nome Descrizione Valore
contactEmails 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)
contactGroups 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. string[]
contactRoles Contattare i ruoli per inviare la notifica del budget a quando viene superata la soglia. string[]
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. 'EqualTo'
'GreaterThan'
'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 'Actual'

Esempi di avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Bicep File 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.

Definizione di risorsa del modello di Resource Manager

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

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

Formato risorsa

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

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2019-10-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" ]
      },
      "not": {
        "dimensions": {
          "name": "string",
          "operator": "string",
          "values": [ "string" ]
        },
        "tags": {
          "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à

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
non Espressione logica "NOT". BudgetFilterProperties
Tag Ha un'espressione di confronto per un tag BudgetComparisonExpression

BudgetFilterProperties

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

BudgetProperties

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. BudgetPropertiesNotifications
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 'Annually'
'BillingAnnual'
'BillingMonth'
'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)

BudgetPropertiesNotifications

Nome Descrizione Valore

BudgetTimePeriod

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

Microsoft.Consumption/budget

Nome Descrizione Valore
apiVersion Versione dell'API '2019-10-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. BudgetProperties
digitare Tipo di risorsa 'Microsoft.Consumption/budget'

Notifica

Nome Descrizione Valore
contactEmails 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)
contactGroups 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. string[]
contactRoles Contattare i ruoli per inviare la notifica del budget a quando viene superata la soglia. string[]
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. 'EqualTo'
'GreaterThan'
'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 'Actual'

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Sagoma Descrizione
Creare un di budget

Distribuire in Azure 		Questo modello illustra come creare un budget in una sottoscrizione.
Creare un budget con di filtro

Distribuire in Azure 		Questo modello illustra come creare un budget in una sottoscrizione.
Creare un di budget semplice

Distribuire in Azure 		Questo modello illustra come creare un budget in una sottoscrizione.

Definizione di risorsa Terraform (provider AzAPI)

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

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

Formato risorsa

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2019-10-01"
  name = "string"
  parent_id = "string"
  eTag = "string"
  body = jsonencode({
    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"
          ]
        }
        not = {
          dimensions = {
            name = "string"
            operator = "string"
            values = [
              "string"
            ]
          }
          tags = {
            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à

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
non Espressione logica "NOT". BudgetFilterProperties
Tag Ha un'espressione di confronto per un tag BudgetComparisonExpression

BudgetFilterProperties

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

BudgetProperties

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. BudgetPropertiesNotifications
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 'Annually'
'BillingAnnual'
'BillingMonth'
'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)

BudgetPropertiesNotifications

Nome Descrizione Valore

BudgetTimePeriod

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

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. BudgetProperties
digitare Tipo di risorsa "Microsoft.Consumption/budgets@2019-10-01"

Notifica

Nome Descrizione Valore
contactEmails 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)
contactGroups 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. string[]
contactRoles Contattare i ruoli per inviare la notifica del budget a quando viene superata la soglia. string[]
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. 'EqualTo'
'GreaterThan'
'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 'Actual'