Share via


Budget microsoft.consumo 2019-05-01-preview

Definizione di risorsa Bicep

Il tipo di risorsa budget è una risorsa di estensione, che significa che è possibile applicarla a un'altra risorsa.

Utilizzare la proprietà in questa risorsa per impostare l'ambito scope per questa risorsa. Vedere Impostare l'ambito sulle risorse di estensione in Bicep.

Gli ambiti di distribuzione validi per la risorsa budget sono:

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

Formato di risorsa

Per creare una risorsa Microsoft.Consumo/budget, aggiungere il modello Bicep seguente.

resource symbolicname 'Microsoft.Consumption/budgets@2019-05-01-preview' = {
  name: 'string'
  scope: resourceSymbolicName
  eTag: 'string'
  properties: {
    amount: int
    category: 'string'
    filters: {
      meters: [
        'string'
      ]
      resourceGroups: [
        'string'
      ]
      resources: [
        'string'
      ]
      tags: {}
    }
    notifications: {}
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

Valori delle proprietà

budgets

Nome Descrizione valore
name Nome della risorsa stringa (obbligatoria)

Limite di caratteri: 1-63

Caratteri validi:
Caratteri alfanumerici, trattini e caratteri di sottolineatura.
ambito Usare quando si crea una risorsa di estensione in un ambito diverso dall'ambito di distribuzione. Risorsa di destinazione

Per Bicep, impostare questa proprietà sul nome simbolico della risorsa per applicare la risorsa di estensione.
eTag eTag della risorsa. Per gestire lo scenario di aggiornamento simultaneo, questo campo verrà usato per determinare se l'utente sta aggiornando la versione più recente o meno. string
properties Proprietà del budget. BudgetProperties

BudgetProperties

Nome Descrizione valore
amount Importo totale dei costi da tenere traccia del budget int (obbligatorio)
category Categoria del budget, indipendentemente dal fatto che il budget tiene traccia dei costi o dell'utilizzo. 'Costo'
'Utilizzo' (obbligatorio)
filters Può essere usato per filtrare i budget in base al gruppo di risorse, alla risorsa o al contatore. Filtri
Notifiche Dizionario delle notifiche associate al budget. Il budget può avere fino a cinque notifiche. object
timeGrain Tempo coperto da un budget. Il rilevamento della quantità verrà reimpostato in base alla granularità temporale. 'Annually'
'Mensile'
'Trimestrale' (obbligatorio)
timePeriod Data di inizio e fine del budget. La data di inizio deve essere prima del mese e deve essere inferiore alla 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 tre mesi. La data di inizio precedente deve essere selezionata entro il periodo di tempo. Non esistono restrizioni sulla data di fine. BudgetTimePeriod (obbligatorio)

Filtri

Nome Descrizione valore
Metri Elenco dei filtri nei contatori (GUID), obbligatorio per i budget della categoria di utilizzo. string[]
resourceGroups Elenco di filtri nei gruppi di risorse, consentiti solo a livello di sottoscrizione. string[]
resources Elenco di filtri sulle risorse. string[]
tags Dizionario dei filtri sui tag. object

BudgetTimePeriod

Nome Descrizione valore
endDate Data di fine del budget. Se non specificato, il valore predefinito è 10 anni dalla data di inizio. string
startDate Data di inizio per il budget. stringa (obbligatoria)

Modelli di avvio rapido

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

Modello Descrizione
Creare un budget

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

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

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

Definizione della risorsa modello di Resource Manager

Il tipo di risorsa budget è una risorsa di estensione, che significa che è possibile applicarla a un'altra risorsa.

Utilizzare la proprietà in questa risorsa per impostare l'ambito scope per questa risorsa. Vedere Impostare l'ambito sulle risorse di estensione nei modelli di Resource Manager.

Gli ambiti di distribuzione validi per la risorsa budget sono:

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

Formato di risorsa

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

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2019-05-01-preview",
  "name": "string",
  "scope": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "string",
    "filters": {
      "meters": [ "string" ],
      "resourceGroups": [ "string" ],
      "resources": [ "string" ],
      "tags": {}
    },
    "notifications": {},
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

Valori delle proprietà

budgets

Nome Descrizione valore
tipo Tipo di risorsa 'Microsoft.Consumo/budget'
apiVersion Versione dell'API risorsa '2019-05-01-preview'
name Nome della risorsa stringa (obbligatoria)

Limite di caratteri: 1-63

Caratteri validi:
Caratteri alfanumerici, trattini e caratteri di sottolineatura.
ambito Usare quando si crea una risorsa di estensione in un ambito diverso dall'ambito di distribuzione. Risorsa di destinazione

Per JSON, impostare il valore sul nome completo della risorsa per applicare la risorsa di estensione a.
eTag eTag della risorsa. Per gestire lo scenario di aggiornamento simultaneo, questo campo verrà usato per determinare se l'utente sta aggiornando la versione più recente o meno. string
properties Proprietà del budget. BudgetProperties

BudgetProperties

Nome Descrizione valore
amount Importo totale dei costi da tenere traccia del budget int (obbligatorio)
category Categoria del budget, indipendentemente dal fatto che il budget tiene traccia dei costi o dell'utilizzo. 'Costo'
'Utilizzo' (obbligatorio)
filters Può essere usato per filtrare i budget in base al gruppo di risorse, alla risorsa o al contatore. Filtri
Notifiche Dizionario delle notifiche associate al budget. Il budget può avere fino a cinque notifiche. object
timeGrain Tempo coperto da un budget. Il rilevamento della quantità verrà reimpostato in base alla granularità temporale. 'Annually'
'Mensile'
'Trimestrale' (obbligatorio)
timePeriod Data di inizio e fine del budget. La data di inizio deve essere prima del mese e deve essere inferiore alla 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 tre mesi. La data di inizio precedente deve essere selezionata entro il periodo di tempo. Non esistono restrizioni sulla data di fine. BudgetTimePeriod (obbligatorio)

Filtri

Nome Descrizione valore
Metri Elenco dei filtri nei contatori (GUID), obbligatorio per i budget della categoria di utilizzo. string[]
resourceGroups Elenco di filtri nei gruppi di risorse, consentiti solo a livello di sottoscrizione. string[]
resources Elenco di filtri sulle risorse. string[]
tags Dizionario dei filtri sui tag. object

BudgetTimePeriod

Nome Descrizione valore
endDate Data di fine del budget. Se non specificato, il valore predefinito è 10 anni dalla data di inizio. string
startDate Data di inizio per il budget. stringa (obbligatoria)

Modelli di avvio rapido

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

Modello Descrizione
Creare un budget

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

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

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

Definizione della risorsa Terraform (provider AzAPI)

Il tipo di risorsa budget è una risorsa di estensione, che significa che è possibile applicarla a un'altra risorsa.

Utilizzare la proprietà in questa risorsa per impostare l'ambito parent_id per questa risorsa.

Gli ambiti di distribuzione validi per la risorsa budget sono:

  • Gruppi di risorse
  • Sottoscrizioni

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

Formato di risorsa

Per creare una risorsa Microsoft.Consumo/budget, aggiungere il modello terraform seguente.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2019-05-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      amount = int
      category = "string"
      filters = {
        meters = [
          "string"
        ]
        resourceGroups = [
          "string"
        ]
        resources = [
          "string"
        ]
        tags = {}
      }
      notifications = {}
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
    eTag = "string"
  })
}

Valori delle proprietà

budgets

Nome Descrizione valore
tipo Tipo di risorsa "Microsoft.Consumption/budgets@2019-05-01-preview"
name Nome della risorsa stringa (obbligatoria)

Limite di caratteri: 1-63

Caratteri validi:
Caratteri alfanumerici, trattini e caratteri di sottolineatura.
parent_id ID della risorsa a cui applicare questa risorsa di estensione. stringa (obbligatoria)
eTag eTag della risorsa. Per gestire lo scenario di aggiornamento simultaneo, questo campo verrà usato per determinare se l'utente sta aggiornando la versione più recente o meno. string
properties Proprietà del budget. BudgetProperties

BudgetProperties

Nome Descrizione valore
amount Importo totale dei costi da tenere traccia del budget int (obbligatorio)
category Categoria del budget, indipendentemente dal fatto che il budget tiene traccia dei costi o dell'utilizzo. "Costo"
"Utilizzo" (obbligatorio)
filters Può essere usato per filtrare i budget in base al gruppo di risorse, alla risorsa o al contatore. Filtri
Notifiche Dizionario delle notifiche associate al budget. Il budget può avere fino a cinque notifiche. object
timeGrain Tempo coperto da un budget. Il rilevamento della quantità verrà reimpostato in base alla granularità temporale. "Annually"
"Mensile"
"Trimestrale" (obbligatorio)
timePeriod Data di inizio e fine del budget. La data di inizio deve essere prima del mese e deve essere inferiore alla 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 tre mesi. La data di inizio precedente deve essere selezionata entro il periodo di tempo. Non esistono restrizioni sulla data di fine. BudgetTimePeriod (obbligatorio)

Filtri

Nome Descrizione valore
Metri Elenco dei filtri nei contatori (GUID), obbligatorio per i budget della categoria di utilizzo. string[]
resourceGroups Elenco di filtri nei gruppi di risorse, consentiti solo a livello di sottoscrizione. string[]
resources Elenco di filtri sulle risorse. string[]
tags Dizionario dei filtri sui tag. object

BudgetTimePeriod

Nome Descrizione valore
endDate Data di fine del budget. Se non specificato, il valore predefinito è 10 anni dalla data di inizio. string
startDate Data di inizio per il budget. stringa (obbligatoria)