Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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 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@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"
}
}
}
}