Budżety Microsoft.Consumption 2023-03-01
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@2023-03-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
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 |
| 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) |
| Ustawień regionalnych | 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) |
| 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": "2023-03-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
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 |
| 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 | '2023-03-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) |
| Ustawień regionalnych | 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) |
| 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@2023-03-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"
]
}
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
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 |
| 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@2023-03-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) |
| Ustawień regionalnych | 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) |
| thresholdType | Typ progu | "Rzeczywisty" "Prognozowane" |