Budżety Microsoft.Consumption 2018-01-31

• najnowsze
• 2024-08-01
• 2023-11-01
• 2023-05-01
• 2023-03-01
• 2022-09-01
• 2021-10-01
• 2021-05-01
• 2019-11-01
• 2019-10-01
• 2019-06-01
• 2019-05-01
• 2019-05-01-podgląd
• 2019-04-01-podgląd
• 2019-01-01
• 2018-10-01
• 2018-08-31
• 2018-06-30
• 2018-03-31
• 2018-01-31
• 2017-12-30-podgląd

Definicja zasobu Bicep

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

• Subskrypcja — zobacz polecenia wdrażania subskrypcji * grupy zasobów — zobacz polecenia wdrażania grupy zasobów

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@2018-01-31' = {
  eTag: 'string'
  name: 'string'
  properties: {
    amount: int
    category: 'string'
    filters: {
      meters: [
        'string'
      ]
      resourceGroups: [
        'string'
      ]
      resources: [
        'string'
      ]
    }
    notifications: {
      {customized property}: {
        contactEmails: [
          'string'
        ]
        contactGroups: [
          'string'
        ]
        contactRoles: [
          'string'
        ]
        enabled: bool
        operator: 'string'
        threshold: int
      }
    }
    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.	struna
nazwa	Nazwa zasobu	ciąg (wymagany)
Właściwości	Właściwości budżetu.	Właściwości 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" "Użycie" (wymagane)
Filtry	Może służyć do filtrowania budżetów według grupy zasobów, zasobu lub miernika.	filtry
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.	"Rocznie" "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ż trzy miesiące. 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.	struna
data rozpoczęcia	Data rozpoczęcia budżetu.	ciąg (wymagany)

Filtry

Nazwa	Opis	Wartość
Metrów	Lista filtrów według mierników, obowiązkowa dla budżetów kategorii użycia.	ciąg znakowy[]
Grupy zasobów	Lista filtrów dla grup zasobów dozwolonych tylko na poziomie subskrypcji.	ciąg znakowy[]
zasoby	Lista filtrów dotyczących zasobów.	ciąg znakowy[]

Powiadomienie

Nazwa	Opis	Wartość
kontaktE-maile	Adresy e-mail do wysyłania powiadomienia o budżecie do momentu przekroczenia progu.	string[] (wymagane)
KontaktGroups (Kontakty)	Grupy akcji wysyłające powiadomienie o budżecie do momentu przekroczenia progu.	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)
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)

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:

• Subskrypcja — zobacz polecenia wdrażania subskrypcji * grupy zasobów — zobacz polecenia wdrażania grupy zasobów

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": "2018-01-31",
  "name": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "string",
    "filters": {
      "meters": [ "string" ],
      "resourceGroups": [ "string" ],
      "resources": [ "string" ]
    },
    "notifications": {
      "{customized property}": {
        "contactEmails": [ "string" ],
        "contactGroups": [ "string" ],
        "contactRoles": [ "string" ],
        "enabled": "bool",
        "operator": "string",
        "threshold": "int"
      }
    },
    "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	'2018-01-31'
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.	struna
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"

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" "Użycie" (wymagane)
Filtry	Może służyć do filtrowania budżetów według grupy zasobów, zasobu lub miernika.	filtry
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.	"Rocznie" "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ż trzy miesiące. 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.	struna
data rozpoczęcia	Data rozpoczęcia budżetu.	ciąg (wymagany)

Filtry

Nazwa	Opis	Wartość
Metrów	Lista filtrów według mierników, obowiązkowa dla budżetów kategorii użycia.	ciąg znakowy[]
Grupy zasobów	Lista filtrów dla grup zasobów dozwolonych tylko na poziomie subskrypcji.	ciąg znakowy[]
zasoby	Lista filtrów dotyczących zasobów.	ciąg znakowy[]

Powiadomienie

Nazwa	Opis	Wartość
kontaktE-maile	Adresy e-mail do wysyłania powiadomienia o budżecie do momentu przekroczenia progu.	string[] (wymagane)
KontaktGroups (Kontakty)	Grupy akcji wysyłające powiadomienie o budżecie do momentu przekroczenia progu.	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)
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)

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 tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji.
Tworzenie budżetu przy użyciu filtru wdrażanie	W tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji.
tworzenie prostego budżetu wdrażanie	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:

• subskrypcji* grupy zasobów

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@2018-01-31"
  name = "string"
  parent_id = "string"
  body = {
    eTag = "string"
    properties = {
      amount = int
      category = "string"
      filters = {
        meters = [
          "string"
        ]
        resourceGroups = [
          "string"
        ]
        resources = [
          "string"
        ]
      }
      notifications = {
        {customized property} = {
          contactEmails = [
            "string"
          ]
          contactGroups = [
            "string"
          ]
          contactRoles = [
            "string"
          ]
          enabled = bool
          operator = "string"
          threshold = int
        }
      }
      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.	struna
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@2018-01-31"

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" "Użycie" (wymagane)
Filtry	Może służyć do filtrowania budżetów według grupy zasobów, zasobu lub miernika.	filtry
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.	"Rocznie" "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ż trzy miesiące. 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.	struna
data rozpoczęcia	Data rozpoczęcia budżetu.	ciąg (wymagany)

Filtry

Nazwa	Opis	Wartość
Metrów	Lista filtrów według mierników, obowiązkowa dla budżetów kategorii użycia.	ciąg znakowy[]
Grupy zasobów	Lista filtrów dla grup zasobów dozwolonych tylko na poziomie subskrypcji.	ciąg znakowy[]
zasoby	Lista filtrów dotyczących zasobów.	ciąg znakowy[]

Powiadomienie

Nazwa	Opis	Wartość
kontaktE-maile	Adresy e-mail do wysyłania powiadomienia o budżecie do momentu przekroczenia progu.	string[] (wymagane)
KontaktGroups (Kontakty)	Grupy akcji wysyłające powiadomienie o budżecie do momentu przekroczenia progu.	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)
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)