Budżety Microsoft.Consumption 2019-05-01-preview

• 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-preview
• 2019-04-01-preview
• 2019-01-01
• 2018-10-01
• 2018-08-31
• 2018-06-30
• 2018-03-31
• 2018-01-31
• 2017-12-30-preview

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@2019-05-01-preview' = {
  scope: resourceSymbolicName or scope
  eTag: 'string'
  name: 'string'
  properties: {
    amount: int
    category: 'string'
    filters: {
      meters: [
        'string'
      ]
      resourceGroups: [
        'string'
      ]
      resources: [
        'string'
      ]
      tags: {
        {customized property}: [
          '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

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
timeGrain	Czas objęty budżetem. Śledzenie ilości zostanie zresetowane na podstawie ziarna czasu.	"Rocznie" "Co miesiąc" "Kwartalny" (wymagany)
timePeriod	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

Nazwa	Opis	Wartość

BudgetTimePeriod

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

Filtry

Nazwa	Opis	Wartość
Metrów	Lista filtrów mierników (GUID), obowiązkowych dla budżetów kategorii użycia.	struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
resourceGroups	Lista filtrów dla grup zasobów dozwolonych tylko na poziomie subskrypcji.	string[]
zasoby	Lista filtrów dotyczących zasobów.	string[]
Tagi	Słownik filtrów tagów.	filtry Tagi

FiltryTagi

Nazwa	Opis	Wartość

Microsoft.Consumption/budgets

Nazwa	Opis	Wartość
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.	BudgetProperties
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 .

Powiadomienie

Nazwa	Opis	Wartość
contactEmails	Adresy e-mail do wysyłania powiadomienia o budżecie do momentu przekroczenia progu.	string[] (wymagane)
contactGroups	Grupy akcji wysyłające powiadomienie o budżecie do momentu przekroczenia progu.	string[]
contactRoles	Role kontaktu w celu wysłania powiadomienia o budżecie do momentu przekroczenia progu.	string[]
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 z przewodnika Szybki start

W poniższych przykładach szybkiego startu wdrożono ten typ 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": "2019-05-01-preview",
  "name": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "string",
    "filters": {
      "meters": [ "string" ],
      "resourceGroups": [ "string" ],
      "resources": [ "string" ],
      "tags": {
        "{customized property}": [ "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

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
timeGrain	Czas objęty budżetem. Śledzenie ilości zostanie zresetowane na podstawie ziarna czasu.	"Rocznie" "Co miesiąc" "Kwartalny" (wymagany)
timePeriod	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

Nazwa	Opis	Wartość

BudgetTimePeriod

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

Filtry

Nazwa	Opis	Wartość
Metrów	Lista filtrów mierników (GUID), obowiązkowych dla budżetów kategorii użycia.	struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
resourceGroups	Lista filtrów dla grup zasobów dozwolonych tylko na poziomie subskrypcji.	string[]
zasoby	Lista filtrów dotyczących zasobów.	string[]
Tagi	Słownik filtrów tagów.	filtry Tagi

FiltryTagi

Nazwa	Opis	Wartość

Microsoft.Consumption/budgets

Nazwa	Opis	Wartość
apiVersion	Wersja interfejsu API	"2019-05-01-preview"
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.	BudgetProperties
typ	Typ zasobu	"Microsoft.Consumption/budgets"

Powiadomienie

Nazwa	Opis	Wartość
contactEmails	Adresy e-mail do wysyłania powiadomienia o budżecie do momentu przekroczenia progu.	string[] (wymagane)
contactGroups	Grupy akcji wysyłające powiadomienie o budżecie do momentu przekroczenia progu.	string[]
contactRoles	Role kontaktu w celu wysłania powiadomienia o budżecie do momentu przekroczenia progu.	string[]
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)

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają 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:

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@2019-05-01-preview"
  name = "string"
  parent_id = "string"
  eTag = "string"
  body = jsonencode({
    properties = {
      amount = int
      category = "string"
      filters = {
        meters = [
          "string"
        ]
        resourceGroups = [
          "string"
        ]
        resources = [
          "string"
        ]
        tags = {
          {customized property} = [
            "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

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
timeGrain	Czas objęty budżetem. Śledzenie ilości zostanie zresetowane na podstawie ziarna czasu.	"Rocznie" "Co miesiąc" "Kwartalny" (wymagany)
timePeriod	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

Nazwa	Opis	Wartość

BudgetTimePeriod

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

Filtry

Nazwa	Opis	Wartość
Metrów	Lista filtrów mierników (GUID), obowiązkowych dla budżetów kategorii użycia.	struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
resourceGroups	Lista filtrów dla grup zasobów dozwolonych tylko na poziomie subskrypcji.	string[]
zasoby	Lista filtrów dotyczących zasobów.	string[]
Tagi	Słownik filtrów tagów.	filtry Tagi

FiltryTagi

Nazwa	Opis	Wartość

Microsoft.Consumption/budgets

Nazwa	Opis	Wartość
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)
parent_id	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.	BudgetProperties
typ	Typ zasobu	"Microsoft.Consumption/budgets@2019-05-01-preview"

Powiadomienie

Nazwa	Opis	Wartość
contactEmails	Adresy e-mail do wysyłania powiadomienia o budżecie do momentu przekroczenia progu.	string[] (wymagane)
contactGroups	Grupy akcji wysyłające powiadomienie o budżecie do momentu przekroczenia progu.	string[]
contactRoles	Role kontaktu w celu wysłania powiadomienia o budżecie do momentu przekroczenia progu.	string[]
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)