Freigeben über


Microsoft.Consumption Budgets 2019-10-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@2019-10-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'
        ]
      }
      not: {
        dimensions: {
          name: 'string'
          operator: 'string'
          values: [
            'string'
          ]
        }
        tags: {
          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
nicht Der logische "NOT"-Ausdruck. BudgetFilterProperties-
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"

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-10-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" ]
      },
      "not": {
        "dimensions": {
          "name": "string",
          "operator": "string",
          "values": [ "string" ]
        },
        "tags": {
          "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
nicht Der logische "NOT"-Ausdruck. BudgetFilterProperties-
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 '2019-10-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"

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone Beschreibung
Erstellen eines Budget-

Bereitstellen in Azure
Diese Vorlage zeigt, wie Sie ein Budget unter einem Abonnement erstellen.
Erstellen eines Budgets mit Filter-

Bereitstellen in Azure
Diese Vorlage zeigt, wie Sie ein Budget unter einem Abonnement erstellen.
Erstellen eines einfachen Budget-

Bereitstellen in Azure
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-10-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"
          ]
        }
        not = {
          dimensions = {
            name = "string"
            operator = "string"
            values = [
              "string"
            ]
          }
          tags = {
            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
nicht Der logische "NOT"-Ausdruck. BudgetFilterProperties-
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@2019-10-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"