Udostępnij przez


Budżety Microsoft.Consumption

Definicja zasobu Bicep

Typ zasobu budżetów można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Consumption/budgets, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

Microsoft.Consumption/budgets

Nazwa Opis Wartość
Znacznik elektroniczny (eTag) Element eTag zasobu. Aby obsłużyć scenariusz aktualizacji współbieżnych, to pole będzie używane do określenia, czy użytkownik aktualizuje najnowszą wersję, czy nie. ciąg
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości budżetu. Właściwości budżetu
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia .

Wyrażenie porównania budżetu

Nazwa Opis Wartość
nazwa Nazwa kolumny do użycia w porównaniu. ciąg (wymagany)
operator Operator, który ma być używany do porównania. 'In' (wymagane)
Wartości Tablica wartości do użycia do porównania string[] (wymagane)

Filtr budżetu

Nazwa Opis Wartość
i Logiczne wyrażenie "AND". Musi zawierać co najmniej 2 elementy. Właściwości filtru budżetu[]
Wymiary Zawiera wyrażenie porównania dla wymiaru Wyrażenie porównania budżetu
Tagi Zawiera wyrażenie porównania dla tagu Wyrażenie porównania budżetu

Właściwości filtru budżetu

Nazwa Opis Wartość
Wymiary Zawiera wyrażenie porównania dla wymiaru Wyrażenie porównania budżetu
Tagi Zawiera wyrażenie porównania dla tagu Wyrażenie porównania budżetu

Właściwości budżetu

Nazwa Opis Wartość
kwota Łączna kwota kosztów do śledzenia przy użyciu budżetu int (wymagane)
kategoria Kategoria budżetu, niezależnie od tego, czy budżet śledzi koszt, czy użycie. "Koszt" (wymagany)
filtr Może służyć do filtrowania budżetów według wymiarów określonych przez użytkownika i/lub tagów. Filtr budżetu
Powiadomienia Słownik powiadomień skojarzonych z budżetem. Budżet może mieć maksymalnie pięć powiadomień. BudgetPropertiesNotifications (Powiadomienia o właściwościach budżetu)
czasZiarno Czas objęty budżetem. Śledzenie ilości zostanie zresetowane na podstawie ziarna czasu. RozliczeniaMonth, BillingQuarter i BillingAnnual są obsługiwane tylko przez klientów usługi WD "Rocznie"
"RozliczeniaAnnual"
"Miesiąc rozliczeniowy"
"BillingQuarter"
"Co miesiąc"
"Kwartalny" (wymagany)
timePeriod (okres czasu) Ma datę rozpoczęcia i zakończenia budżetu. Data rozpoczęcia musi być pierwsza z miesiąca i powinna być mniejsza niż data zakończenia. Data rozpoczęcia budżetu musi być 1 czerwca 2017 r. lub późniejsza. Data rozpoczęcia w przyszłości nie powinna być większa niż dwanaście miesięcy. W przedziale czasu należy wybrać poprzednią datę rozpoczęcia. Nie ma żadnych ograniczeń dotyczących daty zakończenia. BudgetTimePeriod (wymagane)

BudgetPropertiesNotifications (Powiadomienia o właściwościach budżetu)

Nazwa Opis Wartość

Okres budżetowy

Nazwa Opis Wartość
data zakończenia Data zakończenia budżetu. Jeśli nie zostanie podana, wartość domyślna to 10 lat od daty rozpoczęcia. ciąg
data rozpoczęcia Data rozpoczęcia budżetu. ciąg (wymagany)

Powiadomienie

Nazwa Opis Wartość
kontaktE-maile Adresy e-mail do wysyłania powiadomienia o budżecie do momentu przekroczenia progu. Musi mieć co najmniej jedną kontaktowy adres e-mail lub grupę kontaktów określoną w zakresach Subskrypcja lub Grupa zasobów. Wszystkie inne zakresy muszą mieć określony co najmniej jeden kontaktowy adres e-mail. string[] (wymagane)
KontaktGroups (Kontakty) Grupy akcji wysyłające powiadomienie o budżecie do momentu przekroczenia progu. Należy podać jako w pełni kwalifikowany identyfikator zasobu platformy Azure. Obsługiwane tylko w zakresach subskrypcji lub grupy zasobów. ciąg znakowy[]
contactRoles (kontaktRole) Role kontaktu w celu wysłania powiadomienia o budżecie do momentu przekroczenia progu. ciąg znakowy[]
Włączone Powiadomienie jest włączone lub nie. bool (wymagane)
regionalny Język, w którym odbiorca otrzyma powiadomienie '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'
operator Operator porównania. "EqualTo"
"GreaterThan"
"GreaterThanOrEqualTo" (wymagane)
próg Wartość progowa skojarzona z powiadomieniem. Powiadomienie jest wysyłane, gdy koszt przekroczył próg. Zawsze jest to procent i musi należeć do przedziału od 0 do 1000. int (wymagane)
typ_progu Typ progu "Rzeczywisty"
"Prognozowane"

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
budżet użycia Moduł zasobów AVM na potrzeby budżetu użycia

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Opis
Tworzenie budżetu W tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji.
Tworzenie budżetu przy użyciu filtru W tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji.
tworzenie prostego budżetu W tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji.

Definicja zasobu szablonu usługi ARM

Typ zasobu budżetów można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Consumption/budgets, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

Microsoft.Consumption/budgets

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API '2024-08-01'
Znacznik elektroniczny (eTag) Element eTag zasobu. Aby obsłużyć scenariusz aktualizacji współbieżnych, to pole będzie używane do określenia, czy użytkownik aktualizuje najnowszą wersję, czy nie. ciąg
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości budżetu. Właściwości budżetu
typ Typ zasobu "Microsoft.Consumption/budgets"

Wyrażenie porównania budżetu

Nazwa Opis Wartość
nazwa Nazwa kolumny do użycia w porównaniu. ciąg (wymagany)
operator Operator, który ma być używany do porównania. 'In' (wymagane)
Wartości Tablica wartości do użycia do porównania string[] (wymagane)

Filtr budżetu

Nazwa Opis Wartość
i Logiczne wyrażenie "AND". Musi zawierać co najmniej 2 elementy. Właściwości filtru budżetu[]
Wymiary Zawiera wyrażenie porównania dla wymiaru Wyrażenie porównania budżetu
Tagi Zawiera wyrażenie porównania dla tagu Wyrażenie porównania budżetu

Właściwości filtru budżetu

Nazwa Opis Wartość
Wymiary Zawiera wyrażenie porównania dla wymiaru Wyrażenie porównania budżetu
Tagi Zawiera wyrażenie porównania dla tagu Wyrażenie porównania budżetu

Właściwości budżetu

Nazwa Opis Wartość
kwota Łączna kwota kosztów do śledzenia przy użyciu budżetu int (wymagane)
kategoria Kategoria budżetu, niezależnie od tego, czy budżet śledzi koszt, czy użycie. "Koszt" (wymagany)
filtr Może służyć do filtrowania budżetów według wymiarów określonych przez użytkownika i/lub tagów. Filtr budżetu
Powiadomienia Słownik powiadomień skojarzonych z budżetem. Budżet może mieć maksymalnie pięć powiadomień. BudgetPropertiesNotifications (Powiadomienia o właściwościach budżetu)
czasZiarno Czas objęty budżetem. Śledzenie ilości zostanie zresetowane na podstawie ziarna czasu. RozliczeniaMonth, BillingQuarter i BillingAnnual są obsługiwane tylko przez klientów usługi WD "Rocznie"
"RozliczeniaAnnual"
"Miesiąc rozliczeniowy"
"BillingQuarter"
"Co miesiąc"
"Kwartalny" (wymagany)
timePeriod (okres czasu) Ma datę rozpoczęcia i zakończenia budżetu. Data rozpoczęcia musi być pierwsza z miesiąca i powinna być mniejsza niż data zakończenia. Data rozpoczęcia budżetu musi być 1 czerwca 2017 r. lub późniejsza. Data rozpoczęcia w przyszłości nie powinna być większa niż dwanaście miesięcy. W przedziale czasu należy wybrać poprzednią datę rozpoczęcia. Nie ma żadnych ograniczeń dotyczących daty zakończenia. BudgetTimePeriod (wymagane)

BudgetPropertiesNotifications (Powiadomienia o właściwościach budżetu)

Nazwa Opis Wartość

Okres budżetowy

Nazwa Opis Wartość
data zakończenia Data zakończenia budżetu. Jeśli nie zostanie podana, wartość domyślna to 10 lat od daty rozpoczęcia. ciąg
data rozpoczęcia Data rozpoczęcia budżetu. ciąg (wymagany)

Powiadomienie

Nazwa Opis Wartość
kontaktE-maile Adresy e-mail do wysyłania powiadomienia o budżecie do momentu przekroczenia progu. Musi mieć co najmniej jedną kontaktowy adres e-mail lub grupę kontaktów określoną w zakresach Subskrypcja lub Grupa zasobów. Wszystkie inne zakresy muszą mieć określony co najmniej jeden kontaktowy adres e-mail. string[] (wymagane)
KontaktGroups (Kontakty) Grupy akcji wysyłające powiadomienie o budżecie do momentu przekroczenia progu. Należy podać jako w pełni kwalifikowany identyfikator zasobu platformy Azure. Obsługiwane tylko w zakresach subskrypcji lub grupy zasobów. ciąg znakowy[]
contactRoles (kontaktRole) Role kontaktu w celu wysłania powiadomienia o budżecie do momentu przekroczenia progu. ciąg znakowy[]
Włączone Powiadomienie jest włączone lub nie. bool (wymagane)
regionalny Język, w którym odbiorca otrzyma powiadomienie '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'
operator Operator porównania. "EqualTo"
"GreaterThan"
"GreaterThanOrEqualTo" (wymagane)
próg Wartość progowa skojarzona z powiadomieniem. Powiadomienie jest wysyłane, gdy koszt przekroczył próg. Zawsze jest to procent i musi należeć do przedziału od 0 do 1000. int (wymagane)
typ_progu Typ progu "Rzeczywisty"
"Prognozowane"

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Szablon Opis
Tworzenie budżetu

wdrażanie w usłudze Azure
W tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji.
Tworzenie budżetu przy użyciu filtru

wdrażanie w usłudze Azure
W tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji.
tworzenie prostego budżetu

wdrażanie w usłudze Azure
W tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu budżetów można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Consumption/budgets, dodaj następujący program Terraform do szablonu.

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

Wartości właściwości

Microsoft.Consumption/budgets

Nazwa Opis Wartość
Znacznik elektroniczny (eTag) Element eTag zasobu. Aby obsłużyć scenariusz aktualizacji współbieżnych, to pole będzie używane do określenia, czy użytkownik aktualizuje najnowszą wersję, czy nie. ciąg
nazwa Nazwa zasobu ciąg (wymagany)
parent_id (identyfikator rodzica) Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
Właściwości Właściwości budżetu. Właściwości budżetu
typ Typ zasobu "Microsoft.Consumption/budgets@2024-08-01"

Wyrażenie porównania budżetu

Nazwa Opis Wartość
nazwa Nazwa kolumny do użycia w porównaniu. ciąg (wymagany)
operator Operator, który ma być używany do porównania. 'In' (wymagane)
Wartości Tablica wartości do użycia do porównania string[] (wymagane)

Filtr budżetu

Nazwa Opis Wartość
i Logiczne wyrażenie "AND". Musi zawierać co najmniej 2 elementy. Właściwości filtru budżetu[]
Wymiary Zawiera wyrażenie porównania dla wymiaru Wyrażenie porównania budżetu
Tagi Zawiera wyrażenie porównania dla tagu Wyrażenie porównania budżetu

Właściwości filtru budżetu

Nazwa Opis Wartość
Wymiary Zawiera wyrażenie porównania dla wymiaru Wyrażenie porównania budżetu
Tagi Zawiera wyrażenie porównania dla tagu Wyrażenie porównania budżetu

Właściwości budżetu

Nazwa Opis Wartość
kwota Łączna kwota kosztów do śledzenia przy użyciu budżetu int (wymagane)
kategoria Kategoria budżetu, niezależnie od tego, czy budżet śledzi koszt, czy użycie. "Koszt" (wymagany)
filtr Może służyć do filtrowania budżetów według wymiarów określonych przez użytkownika i/lub tagów. Filtr budżetu
Powiadomienia Słownik powiadomień skojarzonych z budżetem. Budżet może mieć maksymalnie pięć powiadomień. BudgetPropertiesNotifications (Powiadomienia o właściwościach budżetu)
czasZiarno Czas objęty budżetem. Śledzenie ilości zostanie zresetowane na podstawie ziarna czasu. RozliczeniaMonth, BillingQuarter i BillingAnnual są obsługiwane tylko przez klientów usługi WD "Rocznie"
"RozliczeniaAnnual"
"Miesiąc rozliczeniowy"
"BillingQuarter"
"Co miesiąc"
"Kwartalny" (wymagany)
timePeriod (okres czasu) Ma datę rozpoczęcia i zakończenia budżetu. Data rozpoczęcia musi być pierwsza z miesiąca i powinna być mniejsza niż data zakończenia. Data rozpoczęcia budżetu musi być 1 czerwca 2017 r. lub późniejsza. Data rozpoczęcia w przyszłości nie powinna być większa niż dwanaście miesięcy. W przedziale czasu należy wybrać poprzednią datę rozpoczęcia. Nie ma żadnych ograniczeń dotyczących daty zakończenia. BudgetTimePeriod (wymagane)

BudgetPropertiesNotifications (Powiadomienia o właściwościach budżetu)

Nazwa Opis Wartość

Okres budżetowy

Nazwa Opis Wartość
data zakończenia Data zakończenia budżetu. Jeśli nie zostanie podana, wartość domyślna to 10 lat od daty rozpoczęcia. ciąg
data rozpoczęcia Data rozpoczęcia budżetu. ciąg (wymagany)

Powiadomienie

Nazwa Opis Wartość
kontaktE-maile Adresy e-mail do wysyłania powiadomienia o budżecie do momentu przekroczenia progu. Musi mieć co najmniej jedną kontaktowy adres e-mail lub grupę kontaktów określoną w zakresach Subskrypcja lub Grupa zasobów. Wszystkie inne zakresy muszą mieć określony co najmniej jeden kontaktowy adres e-mail. string[] (wymagane)
KontaktGroups (Kontakty) Grupy akcji wysyłające powiadomienie o budżecie do momentu przekroczenia progu. Należy podać jako w pełni kwalifikowany identyfikator zasobu platformy Azure. Obsługiwane tylko w zakresach subskrypcji lub grupy zasobów. ciąg znakowy[]
contactRoles (kontaktRole) Role kontaktu w celu wysłania powiadomienia o budżecie do momentu przekroczenia progu. ciąg znakowy[]
Włączone Powiadomienie jest włączone lub nie. bool (wymagane)
regionalny Język, w którym odbiorca otrzyma powiadomienie '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'
operator Operator porównania. "EqualTo"
"GreaterThan"
"GreaterThanOrEqualTo" (wymagane)
próg Wartość progowa skojarzona z powiadomieniem. Powiadomienie jest wysyłane, gdy koszt przekroczył próg. Zawsze jest to procent i musi należeć do przedziału od 0 do 1000. int (wymagane)
typ_progu Typ progu "Rzeczywisty"
"Prognozowane"

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrożenia Budżetu Zużycia.

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