Microsoft.Consumption Budgets 2023-05-01
Bicep-Ressourcendefinition
Der Ressourcentyp "Budgets" kann mit Vorgängen bereitgestellt werden, die folgendes Ziel haben:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Consumption/Budgets-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden Bicep hinzu.
resource symbolicname 'Microsoft.Consumption/budgets@2023-05-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'
}
}
}
Eigenschaftswerte
BudgetComparisonExpression
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Name der Spalte, die im Vergleich verwendet werden soll. | Zeichenfolge (erforderlich) |
| Operator | Der für den Vergleich zu verwendende Operator. | "In" (erforderlich) |
| Werte | Array von Werten, die für den Vergleich verwendet werden sollen | string[] (erforderlich) |
BudgetFilter
| Name | Beschreibung | Wert |
|---|---|---|
| und | Der logische Ausdruck "AND". Mindestens 2 Elemente müssen enthalten sein. | BudgetFilterProperties[] |
| Dimensionen | Hat einen Vergleichsausdruck für eine Dimension | BudgetComparisonExpression |
| Schilder | Hat einen Vergleichsausdruck für ein Tag | BudgetComparisonExpression |
BudgetFilterProperties
| Name | Beschreibung | Wert |
|---|---|---|
| Dimensionen | Hat einen Vergleichsausdruck für eine Dimension | BudgetComparisonExpression |
| Schilder | Hat einen Vergleichsausdruck für ein Tag | BudgetComparisonExpression |
BudgetProperties
| Name | Beschreibung | Wert |
|---|---|---|
| Menge | Der Gesamtbetrag der Kosten, die mit dem Budget nachverfolgt werden sollen | int (erforderlich) |
| Kategorie | Die Kategorie des Budgets, unabhängig davon, ob das Budget Kosten oder Nutzung verfolgt. | "Kosten" (erforderlich) |
| Filter | Kann verwendet werden, um Budgets nach benutzerdefinierten Dimensionen und/oder Tags zu filtern. | BudgetFilter- |
| Benachrichtigungen | Wörterbuch der Benachrichtigungen, die dem Budget zugeordnet sind. Das Budget kann bis zu fünf Benachrichtigungen aufweisen. | BudgetPropertiesNotifications |
| timeGrain | Die von einem Budget abgedeckte Zeit. Die Nachverfolgung der Menge wird basierend auf dem Zeitkorn zurückgesetzt. BillingMonth, BillingQuarter und BillingAnnual werden nur von WD-Kunden unterstützt. | "Jährlich" "Abrechnung jährlich" 'BillingMonth' 'BillingQuarter' "Monatlich" "Vierteljährlich" (erforderlich) |
| timePeriod | Hat den Anfangs- und Endtermin des Budgets. Das Startdatum muss zuerst im Monat sein und sollte kleiner als das Enddatum sein. Der Starttermin des Budgets muss am oder nach dem 1. Juni 2017 erfolgen. Der zukünftige Anfangstermin darf nicht mehr als zwölf Monate betragen. Das datum der letzten Anfangstermine sollte innerhalb des Zeitgrainzeitraums ausgewählt werden. Es gibt keine Einschränkungen für das Enddatum. | BudgetTimePeriod- (erforderlich) |
BudgetPropertiesNotifications
| Name | Beschreibung | Wert |
|---|
BudgetTimePeriod
| Name | Beschreibung | Wert |
|---|---|---|
| endDate | Das Enddatum für das Budget. Wenn nicht angegeben, wird dies standardmäßig auf 10 Jahre ab dem Startdatum festgelegt. | Schnur |
| startDate | Der Anfangstermin für das Budget. | Zeichenfolge (erforderlich) |
Microsoft.Consumption/Budgets
| Name | Beschreibung | Wert |
|---|---|---|
| eTag | eTag der Ressource. Um das Szenario für gleichzeitige Updates zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht. | Schnur |
| Name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| Eigenschaften | Die Eigenschaften des Budgets. | BudgetProperties- |
| Umfang | Verwenden Sie diese Verwendung beim Erstellen einer Ressource in einem Bereich, der sich von dem Bereitstellungsbereich unterscheidet. | Legen Sie diese Eigenschaft auf den symbolischen Namen einer Ressource fest, um die Erweiterungsressourceanzuwenden. |
Benachrichtigung
| Name | Beschreibung | Wert |
|---|---|---|
| contactEmails | E-Mail-Adressen, an die die Budgetbenachrichtigung gesendet werden soll, wenn der Schwellenwert überschritten wird. Mindestens eine Kontakt-E-Mail oder Kontaktgruppe muss im Bereich "Abonnement" oder "Ressourcengruppe" angegeben sein. Alle anderen Bereiche müssen mindestens eine Kontakt-E-Mail angegeben haben. | string[] (erforderlich) |
| contactGroups | Aktionsgruppen, an die die Budgetbenachrichtigung gesendet werden soll, wenn der Schwellenwert überschritten wird. Muss als vollqualifizierte Azure-Ressourcen-ID bereitgestellt werden. Wird nur für Abonnement- oder Ressourcengruppenbereiche unterstützt. | string[] |
| contactRoles | Kontaktrollen, an die die Budgetbenachrichtigung gesendet werden soll, wenn der Schwellenwert überschritten wird. | string[] |
| ermöglichte | Die Benachrichtigung ist aktiviert oder nicht. | bool (erforderlich) |
| Gebietsschema | Sprache, in der der Empfänger die Benachrichtigung erhält | '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 | Der Vergleichsoperator. | 'EqualTo' "GreaterThan" "GreaterThanOrEqualTo" (erforderlich) |
| Schwelle | Schwellenwert, der einer Benachrichtigung zugeordnet ist. Die Benachrichtigung wird gesendet, wenn die Kosten den Schwellenwert überschritten haben. Es ist immer Prozent und muss zwischen 0 und 1000 liegen. | int (erforderlich) |
| thresholdType | Der Typ des Schwellenwerts | "Istwert" "Prognostiziert" |
Schnellstartbeispiele
Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.
| Bicep-Datei | Beschreibung |
|---|---|
| Erstellen eines Budget- | Diese Vorlage zeigt, wie Sie ein Budget unter einem Abonnement erstellen. |
| Erstellen eines Budgets mit Filter- | Diese Vorlage zeigt, wie Sie ein Budget unter einem Abonnement erstellen. |
| Erstellen eines einfachen Budget- | Diese Vorlage zeigt, wie Sie ein Budget unter einem Abonnement erstellen. |
ARM-Vorlagenressourcendefinition
Der Ressourcentyp "Budgets" kann mit Vorgängen bereitgestellt werden, die folgendes Ziel haben:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Ressource "Microsoft.Consumption/budgets" zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.
{
"type": "Microsoft.Consumption/budgets",
"apiVersion": "2023-05-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"
}
}
}
Eigenschaftswerte
BudgetComparisonExpression
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Name der Spalte, die im Vergleich verwendet werden soll. | Zeichenfolge (erforderlich) |
| Operator | Der für den Vergleich zu verwendende Operator. | "In" (erforderlich) |
| Werte | Array von Werten, die für den Vergleich verwendet werden sollen | string[] (erforderlich) |
BudgetFilter
| Name | Beschreibung | Wert |
|---|---|---|
| und | Der logische Ausdruck "AND". Mindestens 2 Elemente müssen enthalten sein. | BudgetFilterProperties[] |
| Dimensionen | Hat einen Vergleichsausdruck für eine Dimension | BudgetComparisonExpression |
| Schilder | Hat einen Vergleichsausdruck für ein Tag | BudgetComparisonExpression |
BudgetFilterProperties
| Name | Beschreibung | Wert |
|---|---|---|
| Dimensionen | Hat einen Vergleichsausdruck für eine Dimension | BudgetComparisonExpression |
| Schilder | Hat einen Vergleichsausdruck für ein Tag | BudgetComparisonExpression |
BudgetProperties
| Name | Beschreibung | Wert |
|---|---|---|
| Menge | Der Gesamtbetrag der Kosten, die mit dem Budget nachverfolgt werden sollen | int (erforderlich) |
| Kategorie | Die Kategorie des Budgets, unabhängig davon, ob das Budget Kosten oder Nutzung verfolgt. | "Kosten" (erforderlich) |
| Filter | Kann verwendet werden, um Budgets nach benutzerdefinierten Dimensionen und/oder Tags zu filtern. | BudgetFilter- |
| Benachrichtigungen | Wörterbuch der Benachrichtigungen, die dem Budget zugeordnet sind. Das Budget kann bis zu fünf Benachrichtigungen aufweisen. | BudgetPropertiesNotifications |
| timeGrain | Die von einem Budget abgedeckte Zeit. Die Nachverfolgung der Menge wird basierend auf dem Zeitkorn zurückgesetzt. BillingMonth, BillingQuarter und BillingAnnual werden nur von WD-Kunden unterstützt. | "Jährlich" "Abrechnung jährlich" 'BillingMonth' 'BillingQuarter' "Monatlich" "Vierteljährlich" (erforderlich) |
| timePeriod | Hat den Anfangs- und Endtermin des Budgets. Das Startdatum muss zuerst im Monat sein und sollte kleiner als das Enddatum sein. Der Starttermin des Budgets muss am oder nach dem 1. Juni 2017 erfolgen. Der zukünftige Anfangstermin darf nicht mehr als zwölf Monate betragen. Das datum der letzten Anfangstermine sollte innerhalb des Zeitgrainzeitraums ausgewählt werden. Es gibt keine Einschränkungen für das Enddatum. | BudgetTimePeriod- (erforderlich) |
BudgetPropertiesNotifications
| Name | Beschreibung | Wert |
|---|
BudgetTimePeriod
| Name | Beschreibung | Wert |
|---|---|---|
| endDate | Das Enddatum für das Budget. Wenn nicht angegeben, wird dies standardmäßig auf 10 Jahre ab dem Startdatum festgelegt. | Schnur |
| startDate | Der Anfangstermin für das Budget. | Zeichenfolge (erforderlich) |
Microsoft.Consumption/Budgets
| Name | Beschreibung | Wert |
|---|---|---|
| apiVersion | Die API-Version | '2023-05-01' |
| eTag | eTag der Ressource. Um das Szenario für gleichzeitige Updates zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht. | Schnur |
| Name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| Eigenschaften | Die Eigenschaften des Budgets. | BudgetProperties- |
| Art | Der Ressourcentyp | "Microsoft.Konsum/Budgets" |
Benachrichtigung
| Name | Beschreibung | Wert |
|---|---|---|
| contactEmails | E-Mail-Adressen, an die die Budgetbenachrichtigung gesendet werden soll, wenn der Schwellenwert überschritten wird. Mindestens eine Kontakt-E-Mail oder Kontaktgruppe muss im Bereich "Abonnement" oder "Ressourcengruppe" angegeben sein. Alle anderen Bereiche müssen mindestens eine Kontakt-E-Mail angegeben haben. | string[] (erforderlich) |
| contactGroups | Aktionsgruppen, an die die Budgetbenachrichtigung gesendet werden soll, wenn der Schwellenwert überschritten wird. Muss als vollqualifizierte Azure-Ressourcen-ID bereitgestellt werden. Wird nur für Abonnement- oder Ressourcengruppenbereiche unterstützt. | string[] |
| contactRoles | Kontaktrollen, an die die Budgetbenachrichtigung gesendet werden soll, wenn der Schwellenwert überschritten wird. | string[] |
| ermöglichte | Die Benachrichtigung ist aktiviert oder nicht. | bool (erforderlich) |
| Gebietsschema | Sprache, in der der Empfänger die Benachrichtigung erhält | '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 | Der Vergleichsoperator. | 'EqualTo' "GreaterThan" "GreaterThanOrEqualTo" (erforderlich) |
| Schwelle | Schwellenwert, der einer Benachrichtigung zugeordnet ist. Die Benachrichtigung wird gesendet, wenn die Kosten den Schwellenwert überschritten haben. Es ist immer Prozent und muss zwischen 0 und 1000 liegen. | int (erforderlich) |
| thresholdType | Der Typ des Schwellenwerts | "Istwert" "Prognostiziert" |
Schnellstartvorlagen
Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.
| Schablone | Beschreibung |
|---|---|
Erstellen eines Budget-
|
Diese Vorlage zeigt, wie Sie ein Budget unter einem Abonnement erstellen. |
|
Erstellen eines Budgets mit Filter-
|
Diese Vorlage zeigt, wie Sie ein Budget unter einem Abonnement erstellen. |
|
Erstellen eines einfachen Budget-
|
Diese Vorlage zeigt, wie Sie ein Budget unter einem Abonnement erstellen. |
Terraform -Ressourcendefinition (AzAPI-Anbieter)
Der Ressourcentyp "Budgets" kann mit Vorgängen bereitgestellt werden, die folgendes Ziel haben:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Ressource "Microsoft.Consumption/budgets" zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Consumption/budgets@2023-05-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"
}
}
})
}
Eigenschaftswerte
BudgetComparisonExpression
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Name der Spalte, die im Vergleich verwendet werden soll. | Zeichenfolge (erforderlich) |
| Operator | Der für den Vergleich zu verwendende Operator. | "In" (erforderlich) |
| Werte | Array von Werten, die für den Vergleich verwendet werden sollen | string[] (erforderlich) |
BudgetFilter
| Name | Beschreibung | Wert |
|---|---|---|
| und | Der logische Ausdruck "AND". Mindestens 2 Elemente müssen enthalten sein. | BudgetFilterProperties[] |
| Dimensionen | Hat einen Vergleichsausdruck für eine Dimension | BudgetComparisonExpression |
| Schilder | Hat einen Vergleichsausdruck für ein Tag | BudgetComparisonExpression |
BudgetFilterProperties
| Name | Beschreibung | Wert |
|---|---|---|
| Dimensionen | Hat einen Vergleichsausdruck für eine Dimension | BudgetComparisonExpression |
| Schilder | Hat einen Vergleichsausdruck für ein Tag | BudgetComparisonExpression |
BudgetProperties
| Name | Beschreibung | Wert |
|---|---|---|
| Menge | Der Gesamtbetrag der Kosten, die mit dem Budget nachverfolgt werden sollen | int (erforderlich) |
| Kategorie | Die Kategorie des Budgets, unabhängig davon, ob das Budget Kosten oder Nutzung verfolgt. | "Kosten" (erforderlich) |
| Filter | Kann verwendet werden, um Budgets nach benutzerdefinierten Dimensionen und/oder Tags zu filtern. | BudgetFilter- |
| Benachrichtigungen | Wörterbuch der Benachrichtigungen, die dem Budget zugeordnet sind. Das Budget kann bis zu fünf Benachrichtigungen aufweisen. | BudgetPropertiesNotifications |
| timeGrain | Die von einem Budget abgedeckte Zeit. Die Nachverfolgung der Menge wird basierend auf dem Zeitkorn zurückgesetzt. BillingMonth, BillingQuarter und BillingAnnual werden nur von WD-Kunden unterstützt. | "Jährlich" "Abrechnung jährlich" 'BillingMonth' 'BillingQuarter' "Monatlich" "Vierteljährlich" (erforderlich) |
| timePeriod | Hat den Anfangs- und Endtermin des Budgets. Das Startdatum muss zuerst im Monat sein und sollte kleiner als das Enddatum sein. Der Starttermin des Budgets muss am oder nach dem 1. Juni 2017 erfolgen. Der zukünftige Anfangstermin darf nicht mehr als zwölf Monate betragen. Das datum der letzten Anfangstermine sollte innerhalb des Zeitgrainzeitraums ausgewählt werden. Es gibt keine Einschränkungen für das Enddatum. | BudgetTimePeriod- (erforderlich) |
BudgetPropertiesNotifications
| Name | Beschreibung | Wert |
|---|
BudgetTimePeriod
| Name | Beschreibung | Wert |
|---|---|---|
| endDate | Das Enddatum für das Budget. Wenn nicht angegeben, wird dies standardmäßig auf 10 Jahre ab dem Startdatum festgelegt. | Schnur |
| startDate | Der Anfangstermin für das Budget. | Zeichenfolge (erforderlich) |
Microsoft.Consumption/Budgets
| Name | Beschreibung | Wert |
|---|---|---|
| eTag | eTag der Ressource. Um das Szenario für gleichzeitige Updates zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht. | Schnur |
| Name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| parent_id | Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. | Zeichenfolge (erforderlich) |
| Eigenschaften | Die Eigenschaften des Budgets. | BudgetProperties- |
| Art | Der Ressourcentyp | "Microsoft.Consumption/budgets@2023-05-01" |
Benachrichtigung
| Name | Beschreibung | Wert |
|---|---|---|
| contactEmails | E-Mail-Adressen, an die die Budgetbenachrichtigung gesendet werden soll, wenn der Schwellenwert überschritten wird. Mindestens eine Kontakt-E-Mail oder Kontaktgruppe muss im Bereich "Abonnement" oder "Ressourcengruppe" angegeben sein. Alle anderen Bereiche müssen mindestens eine Kontakt-E-Mail angegeben haben. | string[] (erforderlich) |
| contactGroups | Aktionsgruppen, an die die Budgetbenachrichtigung gesendet werden soll, wenn der Schwellenwert überschritten wird. Muss als vollqualifizierte Azure-Ressourcen-ID bereitgestellt werden. Wird nur für Abonnement- oder Ressourcengruppenbereiche unterstützt. | string[] |
| contactRoles | Kontaktrollen, an die die Budgetbenachrichtigung gesendet werden soll, wenn der Schwellenwert überschritten wird. | string[] |
| ermöglichte | Die Benachrichtigung ist aktiviert oder nicht. | bool (erforderlich) |
| Gebietsschema | Sprache, in der der Empfänger die Benachrichtigung erhält | '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 | Der Vergleichsoperator. | 'EqualTo' "GreaterThan" "GreaterThanOrEqualTo" (erforderlich) |
| Schwelle | Schwellenwert, der einer Benachrichtigung zugeordnet ist. Die Benachrichtigung wird gesendet, wenn die Kosten den Schwellenwert überschritten haben. Es ist immer Prozent und muss zwischen 0 und 1000 liegen. | int (erforderlich) |
| thresholdType | Der Typ des Schwellenwerts | "Istwert" "Prognostiziert" |