Budżety Microsoft.Consumption 2019-11-01

• 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-11-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
        operator: 'string'
        threshold: int
        thresholdType: 'string'
      }
    }
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

Wartości właściwości

BudgetComparisonExpression

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.	BudgetFilterProperties[]
Wymiary	Zawiera wyrażenie porównania dla wymiaru	BudgetComparisonExpression
nie	Wyrażenie logiczne "NOT".	BudgetFilterProperties
Tagi	Zawiera wyrażenie porównania dla tagu	BudgetComparisonExpression

BudgetFilterProperties

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

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

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)

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. 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)
contactGroups	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.	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)
thresholdType	Typ progu	"Rzeczywisty" "Prognozowane"

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-11-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",
        "operator": "string",
        "threshold": "int",
        "thresholdType": "string"
      }
    },
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

Wartości właściwości

BudgetComparisonExpression

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.	BudgetFilterProperties[]
Wymiary	Zawiera wyrażenie porównania dla wymiaru	BudgetComparisonExpression
nie	Wyrażenie logiczne "NOT".	BudgetFilterProperties
Tagi	Zawiera wyrażenie porównania dla tagu	BudgetComparisonExpression

BudgetFilterProperties

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

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

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)

Microsoft.Consumption/budgets

Nazwa	Opis	Wartość
apiVersion	Wersja interfejsu API	'2019-11-01'
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. 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)
contactGroups	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.	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)
thresholdType	Typ progu	"Rzeczywisty" "Prognozowane"

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-11-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
          operator = "string"
          threshold = int
          thresholdType = "string"
        }
      }
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
  })
}

Wartości właściwości

BudgetComparisonExpression

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.	BudgetFilterProperties[]
Wymiary	Zawiera wyrażenie porównania dla wymiaru	BudgetComparisonExpression
nie	Wyrażenie logiczne "NOT".	BudgetFilterProperties
Tagi	Zawiera wyrażenie porównania dla tagu	BudgetComparisonExpression

BudgetFilterProperties

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

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

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)

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-11-01"

Powiadomienie

Nazwa	Opis	Wartość
contactEmails	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)
contactGroups	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.	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)
thresholdType	Typ progu	"Rzeczywisty" "Prognozowane"