Microsoft.Consumption Budgets 2019-04-01-preview
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@2019-04-01-preview' = {
scope: resourceSymbolicName or scope
eTag: 'string'
name: 'string'
properties: {
amount: int
category: 'string'
filters: {
meters: [
'string'
]
resourceGroups: [
'string'
]
resources: [
'string'
]
tags: {
{customized property}: [
'string'
]
}
}
notifications: {
{customized property}: {
contactEmails: [
'string'
]
contactGroups: [
'string'
]
contactRoles: [
'string'
]
enabled: bool
operator: 'string'
threshold: int
}
}
timeGrain: 'string'
timePeriod: {
endDate: 'string'
startDate: 'string'
}
}
}
Eigenschaftswerte
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" "Verwendung" (erforderlich) |
| Filter | Kann verwendet werden, um Budgets nach Ressourcengruppe, Ressource oder Meter zu filtern. | Filter |
| 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. | "Jährlich" "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 drei 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) |
Filter
| Name | Beschreibung | Wert |
|---|---|---|
| Meter | Die Liste der Filter auf Zählern (GUID), obligatorisch für Budgets der Verwendungskategorie. | Schnur Zwänge: Min. Länge = 36 Maximale Länge = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[] |
| resourceGroups | Die Liste der Filter für Ressourcengruppen, die nur auf Abonnementebene zulässig sind. | string[] |
| Betriebsmittel | Die Liste der Filter für Ressourcen. | string[] |
| Schilder | Das Wörterbuch der Filter für Tags. | FiltersTags- |
FiltersTags
| Name | Beschreibung | Wert |
|---|
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. | string[] (erforderlich) |
| contactGroups | Aktionsgruppen, an die die Budgetbenachrichtigung gesendet werden soll, wenn der Schwellenwert überschritten wird. | 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) |
| 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) |
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": "2019-04-01-preview",
"name": "string",
"eTag": "string",
"properties": {
"amount": "int",
"category": "string",
"filters": {
"meters": [ "string" ],
"resourceGroups": [ "string" ],
"resources": [ "string" ],
"tags": {
"{customized property}": [ "string" ]
}
},
"notifications": {
"{customized property}": {
"contactEmails": [ "string" ],
"contactGroups": [ "string" ],
"contactRoles": [ "string" ],
"enabled": "bool",
"operator": "string",
"threshold": "int"
}
},
"timeGrain": "string",
"timePeriod": {
"endDate": "string",
"startDate": "string"
}
}
}
Eigenschaftswerte
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" "Verwendung" (erforderlich) |
| Filter | Kann verwendet werden, um Budgets nach Ressourcengruppe, Ressource oder Meter zu filtern. | Filter |
| 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. | "Jährlich" "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 drei 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) |
Filter
| Name | Beschreibung | Wert |
|---|---|---|
| Meter | Die Liste der Filter auf Zählern (GUID), obligatorisch für Budgets der Verwendungskategorie. | Schnur Zwänge: Min. Länge = 36 Maximale Länge = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[] |
| resourceGroups | Die Liste der Filter für Ressourcengruppen, die nur auf Abonnementebene zulässig sind. | string[] |
| Betriebsmittel | Die Liste der Filter für Ressourcen. | string[] |
| Schilder | Das Wörterbuch der Filter für Tags. | FiltersTags- |
FiltersTags
| Name | Beschreibung | Wert |
|---|
Microsoft.Consumption/Budgets
| Name | Beschreibung | Wert |
|---|---|---|
| apiVersion | Die API-Version | '2019-04-01-preview' |
| 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. | string[] (erforderlich) |
| contactGroups | Aktionsgruppen, an die die Budgetbenachrichtigung gesendet werden soll, wenn der Schwellenwert überschritten wird. | 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) |
| 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) |
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@2019-04-01-preview"
name = "string"
parent_id = "string"
eTag = "string"
body = jsonencode({
properties = {
amount = int
category = "string"
filters = {
meters = [
"string"
]
resourceGroups = [
"string"
]
resources = [
"string"
]
tags = {
{customized property} = [
"string"
]
}
}
notifications = {
{customized property} = {
contactEmails = [
"string"
]
contactGroups = [
"string"
]
contactRoles = [
"string"
]
enabled = bool
operator = "string"
threshold = int
}
}
timeGrain = "string"
timePeriod = {
endDate = "string"
startDate = "string"
}
}
})
}
Eigenschaftswerte
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" "Verwendung" (erforderlich) |
| Filter | Kann verwendet werden, um Budgets nach Ressourcengruppe, Ressource oder Meter zu filtern. | Filter |
| 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. | "Jährlich" "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 drei 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) |
Filter
| Name | Beschreibung | Wert |
|---|---|---|
| Meter | Die Liste der Filter auf Zählern (GUID), obligatorisch für Budgets der Verwendungskategorie. | Schnur Zwänge: Min. Länge = 36 Maximale Länge = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[] |
| resourceGroups | Die Liste der Filter für Ressourcengruppen, die nur auf Abonnementebene zulässig sind. | string[] |
| Betriebsmittel | Die Liste der Filter für Ressourcen. | string[] |
| Schilder | Das Wörterbuch der Filter für Tags. | FiltersTags- |
FiltersTags
| Name | Beschreibung | Wert |
|---|
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@2019-04-01-preview" |
Benachrichtigung
| Name | Beschreibung | Wert |
|---|---|---|
| contactEmails | E-Mail-Adressen, an die die Budgetbenachrichtigung gesendet werden soll, wenn der Schwellenwert überschritten wird. | string[] (erforderlich) |
| contactGroups | Aktionsgruppen, an die die Budgetbenachrichtigung gesendet werden soll, wenn der Schwellenwert überschritten wird. | 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) |
| 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) |