Microsoft.Consumption Budgets 2019-06-01
Bicep-Ressourcendefinition
Der Ressourcentyp budgets ist eine Erweiterungsressource, was bedeutet, dass Sie sie auf eine andere Ressource anwenden können.
Verwenden Sie die scope
-Eigenschaft für diese Ressource, um den Bereich für diese Ressource festzulegen. Weitere Informationen finden Sie unter Festlegen des Bereichs für Erweiterungsressourcen in Bicep.
Gültige Bereitstellungsbereiche für die Budgetressource sind:
- Ressourcengruppen – Siehe Bereitstellungsbefehle für Ressourcengruppen
- Abonnements – Siehe Befehle zur Abonnementbereitstellung
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-06-01' = {
name: 'string'
scope: resourceSymbolicName
eTag: 'string'
properties: {
amount: int
category: 'string'
filters: {
meters: [
'string'
]
resourceGroups: [
'string'
]
resources: [
'string'
]
tags: {}
}
notifications: {}
timeGrain: 'string'
timePeriod: {
endDate: 'string'
startDate: 'string'
}
}
}
Eigenschaftswerte
budgets
Name | BESCHREIBUNG | Wert |
---|---|---|
name | Der Ressourcenname | Zeichenfolge (erforderlich) Zeichenlimit: 1-63 Gültige Zeichen: Alphanumerische Zeichen, Bindestriche und Unterstriche. |
scope | Verwenden Sie beim Erstellen einer Erweiterungsressource in einem anderen Bereich als dem Bereitstellungsbereich. | Zielressource Legen Sie für Bicep diese Eigenschaft auf den symbolischen Namen der Ressource fest, um die Erweiterungsressource anzuwenden. |
eTag | eTag der Ressource. Um gleichzeitige Updates zu verarbeiten, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht. | Zeichenfolge |
properties | Die Eigenschaften des Budgets. | BudgetEigenschaften |
BudgetEigenschaften
Name | BESCHREIBUNG | Wert |
---|---|---|
Menge | Der Gesamtbetrag der Kosten, die mit dem Budget nachverfolgt werden sollen | int (erforderlich) |
category | Die Kategorie des Budgets, unabhängig davon, ob das Budget die Kosten oder die Nutzung nachverfolgt. | "Kosten" "Nutzung" (erforderlich) |
Filter | Kann verwendet werden, um Budgets nach Ressourcengruppe, Ressource oder Verbrauchseinheit zu filtern. | Filter |
Benachrichtigungen | Wörterbuch der Benachrichtigungen, die dem Budget zugeordnet sind. Das Budget kann bis zu fünf Benachrichtigungen enthalten. | Objekt |
timeGrain | Die durch ein Budget abgedeckte Zeit. Die Nachverfolgung des Betrags wird basierend auf dem Zeitintervall zurückgesetzt. | "Jährlich" "BillingAnnual" "BillingMonth" "BillingQuarter" "Monatlich" "Vierteljährlich" (erforderlich) |
Zeitfenster | Hat Das Start- und Enddatum des Budgets. Das Startdatum muss der Erste des Monats sein und sollte kleiner als das Enddatum sein. Das Startdatum des Budgets muss am oder nach dem 1. Juni 2017 sein. Das zukünftige Startdatum sollte nicht mehr als drei Monate betragen. Das vergangene Startdatum sollte innerhalb des Zeitgrainzeitraums ausgewählt werden. Es gibt keine Einschränkungen für das Enddatum. | BudgetTimePeriod (erforderlich) |
Filter
Name | BESCHREIBUNG | Wert |
---|---|---|
Meter | Die Liste der Filter für Verbrauchseinheiten (GUID), obligatorisch für Budgets der Nutzungskategorie. | string[] |
resourceGroups | Die Liste der Filter für Ressourcengruppen, die nur auf Abonnementebene zulässig sind. | string[] |
ressourcen | Die Liste der Filter für Ressourcen. | string[] |
tags | Das Wörterbuch der Filter für Tags. | Objekt |
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. | Zeichenfolge |
startDate | Das Startdatum für das Budget. | Zeichenfolge (erforderlich) |
Schnellstartvorlagen
In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.
Vorlage | BESCHREIBUNG |
---|---|
Erstellen eines Budgets |
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 Budgets |
Diese Vorlage zeigt, wie Sie ein Budget unter einem Abonnement erstellen. |
Ressourcendefinition mit einer ARM-Vorlage
Der Ressourcentyp budgets ist eine Erweiterungsressource, was bedeutet, dass Sie sie auf eine andere Ressource anwenden können.
Verwenden Sie die scope
-Eigenschaft für diese Ressource, um den Bereich für diese Ressource festzulegen. Weitere Informationen finden Sie unter Festlegen des Bereichs für Erweiterungsressourcen in ARM-Vorlagen.
Gültige Bereitstellungsbereiche für die Budgetressource sind:
- Ressourcengruppen – Siehe Bereitstellungsbefehle für Ressourcengruppen
- Abonnements – Siehe Befehle zur Abonnementbereitstellung
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 der Vorlage den folgenden JSON-Code hinzu.
{
"type": "Microsoft.Consumption/budgets",
"apiVersion": "2019-06-01",
"name": "string",
"scope": "string",
"eTag": "string",
"properties": {
"amount": "int",
"category": "string",
"filters": {
"meters": [ "string" ],
"resourceGroups": [ "string" ],
"resources": [ "string" ],
"tags": {}
},
"notifications": {},
"timeGrain": "string",
"timePeriod": {
"endDate": "string",
"startDate": "string"
}
}
}
Eigenschaftswerte
budgets
Name | BESCHREIBUNG | Wert |
---|---|---|
type | Der Ressourcentyp | "Microsoft.Consumption/budgets" |
apiVersion | Die Version der Ressourcen-API | '2019-06-01' |
name | Der Ressourcenname | Zeichenfolge (erforderlich) Zeichenlimit: 1-63 Gültige Zeichen: Alphanumerische Zeichen, Bindestriche und Unterstriche. |
scope | Verwenden Sie beim Erstellen einer Erweiterungsressource in einem anderen Bereich als dem Bereitstellungsbereich. | Zielressource Legen Sie für JSON den Wert auf den vollständigen Namen der Ressource fest, auf die die Erweiterungsressource angewendet werden soll. |
eTag | eTag der Ressource. Um gleichzeitige Updates zu verarbeiten, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht. | Zeichenfolge |
properties | Die Eigenschaften des Budgets. | BudgetEigenschaften |
BudgetEigenschaften
Name | BESCHREIBUNG | Wert |
---|---|---|
Menge | Der Gesamtbetrag der Kosten, die mit dem Budget nachverfolgt werden sollen | int (erforderlich) |
category | Die Kategorie des Budgets, unabhängig davon, ob das Budget die Kosten oder die Nutzung nachverfolgt. | "Kosten" "Nutzung" (erforderlich) |
Filter | Kann verwendet werden, um Budgets nach Ressourcengruppe, Ressource oder Verbrauchseinheit zu filtern. | Filter |
Benachrichtigungen | Wörterbuch der Benachrichtigungen, die dem Budget zugeordnet sind. Das Budget kann bis zu fünf Benachrichtigungen enthalten. | Objekt |
timeGrain | Die durch ein Budget abgedeckte Zeit. Die Nachverfolgung des Betrags wird basierend auf dem Zeitintervall zurückgesetzt. | "Jährlich" "BillingAnnual" "BillingMonth" "BillingQuarter" "Monatlich" "Vierteljährlich" (erforderlich) |
Zeitfenster | Hat Das Start- und Enddatum des Budgets. Das Startdatum muss der Erste des Monats sein und sollte kleiner als das Enddatum sein. Das Startdatum des Budgets muss am oder nach dem 1. Juni 2017 sein. Das zukünftige Startdatum sollte nicht mehr als drei Monate betragen. Das vergangene Startdatum sollte innerhalb des Zeitgrainzeitraums ausgewählt werden. Es gibt keine Einschränkungen für das Enddatum. | BudgetTimePeriod (erforderlich) |
Filter
Name | BESCHREIBUNG | Wert |
---|---|---|
Meter | Die Liste der Filter für Verbrauchseinheiten (GUID), die für Budgets der Nutzungskategorie obligatorisch ist. | string[] |
resourceGroups | Die Liste der Filter für Ressourcengruppen, die nur auf Abonnementebene zulässig ist. | string[] |
ressourcen | Die Liste der Filter für Ressourcen. | string[] |
tags | Das Wörterbuch der Filter für Tags. | Objekt |
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. | Zeichenfolge |
startDate | Das Startdatum für das Budget. | Zeichenfolge (erforderlich) |
Schnellstartvorlagen
Mit den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.
Vorlage | BESCHREIBUNG |
---|---|
Erstellen eines Budgets |
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 Budgets |
Diese Vorlage zeigt, wie Sie ein Budget unter einem Abonnement erstellen. |
Terraform (AzAPI-Anbieter) Ressourcendefinition
Der Ressourcentyp budgets ist eine Erweiterungsressource, was bedeutet, dass Sie sie auf eine andere Ressource anwenden können.
Verwenden Sie die parent_id
-Eigenschaft für diese Ressource, um den Bereich für diese Ressource festzulegen.
Gültige Bereitstellungsbereiche für die Budgetressource sind:
- Ressourcengruppen
- Abonnements
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 Der Vorlage die folgende Terraform-Ressource hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Consumption/budgets@2019-06-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
amount = int
category = "string"
filters = {
meters = [
"string"
]
resourceGroups = [
"string"
]
resources = [
"string"
]
tags = {}
}
notifications = {}
timeGrain = "string"
timePeriod = {
endDate = "string"
startDate = "string"
}
}
eTag = "string"
})
}
Eigenschaftswerte
budgets
Name | BESCHREIBUNG | Wert |
---|---|---|
type | Ressourcentyp | "Microsoft.Consumption/budgets@2019-06-01" |
name | Der Ressourcenname | Zeichenfolge (erforderlich) Zeichenlimit: 1-63 Gültige Zeichen: Alphanumerische Zeichen, Bindestriche und Unterstriche. |
parent_id | Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. | Zeichenfolge (erforderlich) |
eTag | eTag der Ressource. Um gleichzeitiges Updateszenario zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht. | Zeichenfolge |
properties | Die Eigenschaften des Budgets. | BudgetEigenschaften |
BudgetEigenschaften
Name | BESCHREIBUNG | Wert |
---|---|---|
Menge | Der Gesamtbetrag der kosten, die mit dem Budget nachverfolgt werden sollen | int (erforderlich) |
category | Die Kategorie des Budgets, unabhängig davon, ob das Budget die Kosten oder die Nutzung nachverfolgt. | "Kosten" "Nutzung" (erforderlich) |
Filter | Kann verwendet werden, um Budgets nach Ressourcengruppe, Ressource oder Verbrauchseinheit zu filtern. | Filter |
Benachrichtigungen | Wörterbuch der dem Budget zugeordneten Benachrichtigungen. Budget kann über bis zu fünf Benachrichtigungen verfügen. | Objekt |
timeGrain | Die durch ein Budget abgedeckte Zeit. Die Nachverfolgung des Betrags wird basierend auf dem Zeitkorn zurückgesetzt. | "Jährlich" "BillingAnnual" "BillingMonth" "BillingQuarter" "Monatlich" "Vierteljährlich" (erforderlich) |
Zeitfenster | Hat das Start- und Enddatum des Budgets. Das Startdatum muss der Erste des Monats sein und sollte kleiner als das Enddatum sein. Budgetstartdatum muss am oder nach dem 1. Juni 2017 sein. Das zukünftige Startdatum sollte nicht mehr als drei Monate betragen. Das vergangene Startdatum sollte innerhalb des Zeitraums ausgewählt werden. Es gibt keine Einschränkungen für das Enddatum. | BudgetTimePeriod (erforderlich) |
Filter
Name | BESCHREIBUNG | Wert |
---|---|---|
Meter | Die Liste der Filter für Verbrauchseinheiten (GUID), die für Budgets der Nutzungskategorie obligatorisch ist. | string[] |
resourceGroups | Die Liste der Filter für Ressourcengruppen, die nur auf Abonnementebene zulässig ist. | string[] |
ressourcen | Die Liste der Filter für Ressourcen. | string[] |
tags | Das Wörterbuch der Filter für Tags. | Objekt |
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. | Zeichenfolge |
startDate | Das Startdatum für das Budget. | Zeichenfolge (erforderlich) |