Microsoft.Consumption-budgetar
Bicep-resursdefinition
Resurstypen budgetar kan distribueras med åtgärder som mål:
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.Consumption/budgets-resurs lägger du till följande Bicep i mallen.
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'
}
}
}
Egenskapsvärden
BudgetComparisonExpression
| Namn | Beskrivning | Värde |
|---|---|---|
| Namn | Namnet på kolumnen som ska användas i jämförelse. | sträng (krävs) |
| operatör | Operatorn som ska användas för jämförelse. | "In" (krävs) |
| värden | Matris med värden som ska användas för jämförelse | string[] (krävs) |
BudgetFilter
| Namn | Beskrivning | Värde |
|---|---|---|
| och | Det logiska "AND"-uttrycket. Måste ha minst 2 objekt. | BudgetFilterEgenskaper[] |
| mått | Har jämförelseuttryck för en dimension | BudgetComparisonExpression |
| Taggar | Har jämförelseuttryck för en tagg | BudgetComparisonExpression |
BudgetFilterEgenskaper
| Namn | Beskrivning | Värde |
|---|---|---|
| mått | Har jämförelseuttryck för en dimension | BudgetComparisonExpression |
| Taggar | Har jämförelseuttryck för en tagg | BudgetComparisonExpression |
BudgetEgenskaper
| Namn | Beskrivning | Värde |
|---|---|---|
| belopp | Den totala kostnaden som ska spåras med budgeten | int (krävs) |
| kategori | Kategorin för budgeten, oavsett om budgeten spårar kostnader eller användning. | "Kostnad" (krävs) |
| filter | Kan användas för att filtrera budgetar efter användardefinierade dimensioner och/eller taggar. | BudgetFilter |
| Meddelanden | Ordlista med meddelanden som är associerade med budgeten. Budget kan ha upp till fem meddelanden. | BudgetPropertiesNotifications |
| timeGrain | Den tid som omfattas av en budget. Spårning av beloppet återställs baserat på tidsintervallet. BillingMonth, BillingQuarter och Billing Annual stöds endast av WD-kunder | "Årligen" "Faktureringår" "BillingMonth" "BillingQuarter" "Månadsvis" "Kvartalsvis" (krävs) |
| timePeriod | Har start- och slutdatum för budgeten. Startdatumet måste vara det första i månaden och bör vara mindre än slutdatumet. Budgetstartdatum måste vara den 1 juni 2017 eller senare. Det framtida startdatumet får inte vara längre än tolv månader. Tidigare startdatum bör väljas inom tidsintervallet. Det finns inga begränsningar för slutdatumet. | BudgetTimePeriod (krävs) |
BudgetPropertiesNotifications
| Namn | Beskrivning | Värde |
|---|
BudgetTimePeriod
| Namn | Beskrivning | Värde |
|---|---|---|
| endDate | Slutdatum för budgeten. Om det inte anges är standardinställningen 10 år från startdatumet. | sträng |
| startDate | Startdatum för budgeten. | sträng (krävs) |
Microsoft.Consumption/budgets
| Namn | Beskrivning | Värde |
|---|---|---|
| eTag | eTag för resursen. För att hantera samtidiga uppdateringsscenarion används det här fältet för att avgöra om användaren uppdaterar den senaste versionen eller inte. | sträng |
| Namn | Resursnamnet | sträng (krävs) |
| Egenskaper | Egenskaperna för budgeten. | BudgetEgenskaper |
| omfattning | Använd när du skapar en resurs i ett annat omfång än distributionsomfånget. | Ange den här egenskapen till det symboliska namnet på en resurs för att tillämpa -tilläggsresursen. |
Anmälan
| Namn | Beskrivning | Värde |
|---|---|---|
| contactEmails | E-postadresser för att skicka budgetmeddelandet till när tröskelvärdet överskrids. Minst en kontakt-e-post eller kontaktgrupp måste anges i omfånget Prenumeration eller Resursgrupp. Alla andra omfång måste ha minst en e-postadress för kontakten angiven. | string[] (krävs) |
| contactGroups | Åtgärdsgrupper som ska skicka budgetmeddelandet till när tröskelvärdet överskrids. Måste anges som ett fullständigt kvalificerat Azure-resurs-ID. Stöds endast i prenumerations- eller resursgruppsomfång. | string[] |
| contactRoles | Kontakta roller för att skicka budgetmeddelandet till när tröskelvärdet överskrids. | string[] |
| Aktiverat | Meddelandet är aktiverat eller inte. | bool (krävs) |
| Locale | Språk där mottagaren får meddelandet | "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" |
| operatör | Jämförelseoperatorn. | "EqualTo" "GreaterThan" "GreaterThanOrEqualTo" (krävs) |
| tröskel | Tröskelvärde som är associerat med ett meddelande. Meddelande skickas när kostnaden överskred tröskelvärdet. Det är alltid procent och måste vara mellan 0 och 1000. | int (krävs) |
| thresholdType | Typ av tröskelvärde | "Faktisk" "Prognostiserad" |
Användningsexempel
Azure-verifierade moduler
Följande Azure-verifierade moduler kan användas för att distribuera den här resurstypen.
| Modul | Beskrivning |
|---|---|
| Förbrukningsbudget | AVM-resursmodul för förbrukningsbudget |
Azure-snabbstartsexempel
Följande Azure-snabbstartsmallar innehålla Bicep-exempel för distribution av den här resurstypen.
| Bicep-fil | Beskrivning |
|---|---|
| Skapa en budget | Den här mallen visar hur du skapar en budget under en prenumeration. |
| Skapa en budget med filter | Den här mallen visar hur du skapar en budget under en prenumeration. |
| Skapa en enkel budget | Den här mallen visar hur du skapar en budget under en prenumeration. |
Resursdefinition för ARM-mall
Resurstypen budgetar kan distribueras med åtgärder som mål:
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.Consumption/budgets-resurs lägger du till följande JSON i mallen.
{
"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"
}
}
}
Egenskapsvärden
BudgetComparisonExpression
| Namn | Beskrivning | Värde |
|---|---|---|
| Namn | Namnet på kolumnen som ska användas i jämförelse. | sträng (krävs) |
| operatör | Operatorn som ska användas för jämförelse. | "In" (krävs) |
| värden | Matris med värden som ska användas för jämförelse | string[] (krävs) |
BudgetFilter
| Namn | Beskrivning | Värde |
|---|---|---|
| och | Det logiska "AND"-uttrycket. Måste ha minst 2 objekt. | BudgetFilterEgenskaper[] |
| mått | Har jämförelseuttryck för en dimension | BudgetComparisonExpression |
| Taggar | Har jämförelseuttryck för en tagg | BudgetComparisonExpression |
BudgetFilterEgenskaper
| Namn | Beskrivning | Värde |
|---|---|---|
| mått | Har jämförelseuttryck för en dimension | BudgetComparisonExpression |
| Taggar | Har jämförelseuttryck för en tagg | BudgetComparisonExpression |
BudgetEgenskaper
| Namn | Beskrivning | Värde |
|---|---|---|
| belopp | Den totala kostnaden som ska spåras med budgeten | int (krävs) |
| kategori | Kategorin för budgeten, oavsett om budgeten spårar kostnader eller användning. | "Kostnad" (krävs) |
| filter | Kan användas för att filtrera budgetar efter användardefinierade dimensioner och/eller taggar. | BudgetFilter |
| Meddelanden | Ordlista med meddelanden som är associerade med budgeten. Budget kan ha upp till fem meddelanden. | BudgetPropertiesNotifications |
| timeGrain | Den tid som omfattas av en budget. Spårning av beloppet återställs baserat på tidsintervallet. BillingMonth, BillingQuarter och Billing Annual stöds endast av WD-kunder | "Årligen" "Faktureringår" "BillingMonth" "BillingQuarter" "Månadsvis" "Kvartalsvis" (krävs) |
| timePeriod | Har start- och slutdatum för budgeten. Startdatumet måste vara det första i månaden och bör vara mindre än slutdatumet. Budgetstartdatum måste vara den 1 juni 2017 eller senare. Det framtida startdatumet får inte vara längre än tolv månader. Tidigare startdatum bör väljas inom tidsintervallet. Det finns inga begränsningar för slutdatumet. | BudgetTimePeriod (krävs) |
BudgetPropertiesNotifications
| Namn | Beskrivning | Värde |
|---|
BudgetTimePeriod
| Namn | Beskrivning | Värde |
|---|---|---|
| endDate | Slutdatum för budgeten. Om det inte anges är standardinställningen 10 år från startdatumet. | sträng |
| startDate | Startdatum för budgeten. | sträng (krävs) |
Microsoft.Consumption/budgets
| Namn | Beskrivning | Värde |
|---|---|---|
| apiVersion | API-versionen | '2024-08-01' |
| eTag | eTag för resursen. För att hantera samtidiga uppdateringsscenarion används det här fältet för att avgöra om användaren uppdaterar den senaste versionen eller inte. | sträng |
| Namn | Resursnamnet | sträng (krävs) |
| Egenskaper | Egenskaperna för budgeten. | BudgetEgenskaper |
| typ | Resurstypen | "Microsoft.Consumption/budgets" |
Anmälan
| Namn | Beskrivning | Värde |
|---|---|---|
| contactEmails | E-postadresser för att skicka budgetmeddelandet till när tröskelvärdet överskrids. Minst en kontakt-e-post eller kontaktgrupp måste anges i omfånget Prenumeration eller Resursgrupp. Alla andra omfång måste ha minst en e-postadress för kontakten angiven. | string[] (krävs) |
| contactGroups | Åtgärdsgrupper som ska skicka budgetmeddelandet till när tröskelvärdet överskrids. Måste anges som ett fullständigt kvalificerat Azure-resurs-ID. Stöds endast i prenumerations- eller resursgruppsomfång. | string[] |
| contactRoles | Kontakta roller för att skicka budgetmeddelandet till när tröskelvärdet överskrids. | string[] |
| Aktiverat | Meddelandet är aktiverat eller inte. | bool (krävs) |
| Locale | Språk där mottagaren får meddelandet | "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" |
| operatör | Jämförelseoperatorn. | "EqualTo" "GreaterThan" "GreaterThanOrEqualTo" (krävs) |
| tröskel | Tröskelvärde som är associerat med ett meddelande. Meddelande skickas när kostnaden överskred tröskelvärdet. Det är alltid procent och måste vara mellan 0 och 1000. | int (krävs) |
| thresholdType | Typ av tröskelvärde | "Faktisk" "Prognostiserad" |
Användningsexempel
Azure-snabbstartsmallar
Följande Azure-snabbstartsmallar distribuera den här resurstypen.
| Mall | Beskrivning |
|---|---|
Skapa en budget
|
Den här mallen visar hur du skapar en budget under en prenumeration. |
|
Skapa en budget med filter
|
Den här mallen visar hur du skapar en budget under en prenumeration. |
|
Skapa en enkel budget
|
Den här mallen visar hur du skapar en budget under en prenumeration. |
Resursdefinition för Terraform (AzAPI-provider)
Resurstypen budgetar kan distribueras med åtgärder som mål:
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.Consumption/budgets-resurs lägger du till följande Terraform i mallen.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Consumption/budgets@2024-08-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"
}
}
})
}
Egenskapsvärden
BudgetComparisonExpression
| Namn | Beskrivning | Värde |
|---|---|---|
| Namn | Namnet på kolumnen som ska användas i jämförelse. | sträng (krävs) |
| operatör | Operatorn som ska användas för jämförelse. | "In" (krävs) |
| värden | Matris med värden som ska användas för jämförelse | string[] (krävs) |
BudgetFilter
| Namn | Beskrivning | Värde |
|---|---|---|
| och | Det logiska "AND"-uttrycket. Måste ha minst 2 objekt. | BudgetFilterEgenskaper[] |
| mått | Har jämförelseuttryck för en dimension | BudgetComparisonExpression |
| Taggar | Har jämförelseuttryck för en tagg | BudgetComparisonExpression |
BudgetFilterEgenskaper
| Namn | Beskrivning | Värde |
|---|---|---|
| mått | Har jämförelseuttryck för en dimension | BudgetComparisonExpression |
| Taggar | Har jämförelseuttryck för en tagg | BudgetComparisonExpression |
BudgetEgenskaper
| Namn | Beskrivning | Värde |
|---|---|---|
| belopp | Den totala kostnaden som ska spåras med budgeten | int (krävs) |
| kategori | Kategorin för budgeten, oavsett om budgeten spårar kostnader eller användning. | "Kostnad" (krävs) |
| filter | Kan användas för att filtrera budgetar efter användardefinierade dimensioner och/eller taggar. | BudgetFilter |
| Meddelanden | Ordlista med meddelanden som är associerade med budgeten. Budget kan ha upp till fem meddelanden. | BudgetPropertiesNotifications |
| timeGrain | Den tid som omfattas av en budget. Spårning av beloppet återställs baserat på tidsintervallet. BillingMonth, BillingQuarter och Billing Annual stöds endast av WD-kunder | "Årligen" "Faktureringår" "BillingMonth" "BillingQuarter" "Månadsvis" "Kvartalsvis" (krävs) |
| timePeriod | Har start- och slutdatum för budgeten. Startdatumet måste vara det första i månaden och bör vara mindre än slutdatumet. Budgetstartdatum måste vara den 1 juni 2017 eller senare. Det framtida startdatumet får inte vara längre än tolv månader. Tidigare startdatum bör väljas inom tidsintervallet. Det finns inga begränsningar för slutdatumet. | BudgetTimePeriod (krävs) |
BudgetPropertiesNotifications
| Namn | Beskrivning | Värde |
|---|
BudgetTimePeriod
| Namn | Beskrivning | Värde |
|---|---|---|
| endDate | Slutdatum för budgeten. Om det inte anges är standardinställningen 10 år från startdatumet. | sträng |
| startDate | Startdatum för budgeten. | sträng (krävs) |
Microsoft.Consumption/budgets
| Namn | Beskrivning | Värde |
|---|---|---|
| eTag | eTag för resursen. För att hantera samtidiga uppdateringsscenarion används det här fältet för att avgöra om användaren uppdaterar den senaste versionen eller inte. | sträng |
| Namn | Resursnamnet | sträng (krävs) |
| parent_id | ID:t för resursen som den här tilläggsresursen ska tillämpas på. | sträng (krävs) |
| Egenskaper | Egenskaperna för budgeten. | BudgetEgenskaper |
| typ | Resurstypen | "Microsoft.Consumption/budgets@2024-08-01" |
Anmälan
| Namn | Beskrivning | Värde |
|---|---|---|
| contactEmails | E-postadresser för att skicka budgetmeddelandet till när tröskelvärdet överskrids. Minst en kontakt-e-post eller kontaktgrupp måste anges i omfånget Prenumeration eller Resursgrupp. Alla andra omfång måste ha minst en e-postadress för kontakten angiven. | string[] (krävs) |
| contactGroups | Åtgärdsgrupper som ska skicka budgetmeddelandet till när tröskelvärdet överskrids. Måste anges som ett fullständigt kvalificerat Azure-resurs-ID. Stöds endast i prenumerations- eller resursgruppsomfång. | string[] |
| contactRoles | Kontakta roller för att skicka budgetmeddelandet till när tröskelvärdet överskrids. | string[] |
| Aktiverat | Meddelandet är aktiverat eller inte. | bool (krävs) |
| Locale | Språk där mottagaren får meddelandet | "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" |
| operatör | Jämförelseoperatorn. | "EqualTo" "GreaterThan" "GreaterThanOrEqualTo" (krävs) |
| tröskel | Tröskelvärde som är associerat med ett meddelande. Meddelande skickas när kostnaden överskred tröskelvärdet. Det är alltid procent och måste vara mellan 0 och 1000. | int (krävs) |
| thresholdType | Typ av tröskelvärde | "Faktisk" "Prognostiserad" |