Microsoft.Consumption bütçeleri 2018-10-01

Bicep kaynak tanımı

Bütçe kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kullanım Örnekleri

Bicep Örnekleri

Tüketim Bütçesini dağıtmanın temel bir örneği.

targetScope = 'subscription'

param resourceName string = 'acctest0001'
param location string = 'westus'

resource resourceGroup 'Microsoft.Resources/resourceGroups@2020-06-01' = {
  name: resourceName
  location: location
}

resource budget 'Microsoft.Consumption/budgets@2019-10-01' = {
  name: resourceName
  properties: {
    amount: 1000
    category: 'Cost'
    filter: {
      tags: {
        name: 'foo'
        operator: 'In'
        values: [
          'bar'
        ]
      }
    }
    notifications: {
      'Actual_EqualTo_90.000000_Percent': {
        contactEmails: [
          'foo@example.com'
          'bar@example.com'
        ]
        contactGroups: []
        contactRoles: []
        enabled: true
        operator: 'EqualTo'
        threshold: 90
        thresholdType: 'Actual'
      }
    }
    timeGrain: 'Monthly'
    timePeriod: {
      startDate: '2025-08-01T00:00:00Z'
    }
  }
}

Azure Doğrulanmış Modülleri

Aşağıdaki Azure Doğrulanmış Modüller bu kaynak türünü dağıtmak için kullanılabilir.

Modül Açıklama
Tüketim Bütçesi Tüketim Bütçesi için AVM Kaynak Modülü
Tüketim Bütçesi - Yönetim Grubu Kapsamı AVM Tüketim Bütçesi için Çocuk Modülü - Yönetim Grubu Kapsamı
Tüketim Bütçesi - Kaynak Grubu Kapsamı AVM Tüketim Bütçesi için Çocuk Modülü - Kaynak Grubu Kapsamı
Tüketim Bütçesi - Abonelik Kapsamı AVM Tüketim Bütçesi için Çocuk Modül - Abonelik Kapsamı

Azure Hızlı Başlangıç Örnekleri

Aşağıdaki Azure Hızlı Başlangıç şablonları bu kaynak türünü dağıtmak için Bicep örnekleri içerir.

Bicep Dosyası Açıklama
bütçe oluşturma Bu şablon, bir abonelik altında nasıl bütçe oluşturulacağını gösterir.
Filtre ile Bütçe Oluşturma Bu şablon, bir abonelik altında nasıl bütçe oluşturulacağını gösterir.
Basit Bütçe Oluşturma Bu şablon, bir abonelik altında nasıl bütçe oluşturulacağını gösterir.

Kaynak biçimi

Microsoft.Consumption/budgets kaynağı oluşturmak için şablonunuza aşağıdaki Bicep'i ekleyin.

resource symbolicname 'Microsoft.Consumption/budgets@2018-10-01' = {
  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'
    }
  }
}

Özellik Değerleri

Microsoft.Consumption/budgets

Ad Açıklama Değer
e-Etiket Kaynağın eTag'i. Eşzamanlı güncelleştirme senaryolarını işlemek için, kullanıcının en son sürümü güncelleştirip güncelleştirmediğini belirlemek için bu alan kullanılır. dizgi
ad Kaynak adı dize (gerekli)
Özellikler Bütçenin özellikleri. Bütçe Özellikleri

Bütçe Özellikleri

Ad Açıklama Değer
miktar Bütçeyle izlenen toplam maliyet miktarı int (gerekli)
kategori Bütçenin maliyeti veya kullanımı izlediği bütçe kategorisi. 'Maliyet'
'Kullanım' (gerekli)
Filtre Bütçeleri kaynak grubuna, kaynağa veya ölçüme göre filtrelemek için kullanılabilir. Filtreleri
Bildirim Bütçeyle ilişkili bildirimlerin sözlüğü. Bütçede en fazla beş bildirim olabilir. BudgetPropertiesNotifications
zaman tahıl Bütçenin kapsadığı süre. Miktarın izlenmesi zaman dilimine göre sıfırlanır. 'Yıllık'
'Aylık'
'Üç aylık' (gerekli)
zaman Dilimi Bütçenin başlangıç ve bitiş tarihidir. Başlangıç tarihi ayın ilki olmalı ve bitiş tarihinden küçük olmalıdır. Bütçe başlangıç tarihi 1 Haziran 2017 tarihinde veya sonrasında olmalıdır. Gelecekteki başlangıç tarihi üç aydan uzun olmamalıdır. Geçmiş başlangıç tarihi, zaman dilimi içinde seçilmelidir. Bitiş tarihinde herhangi bir kısıtlama yoktur. BudgetTimePeriod (gerekli)

BudgetPropertiesNotifications

Ad Açıklama Değer

BudgetTimePeriod (Bütçe Süresi)

Ad Açıklama Değer
Bitiş Tarihi Bütçenin bitiş tarihi. Sağlanmadıysa, bunu başlangıç tarihinden itibaren 10 yıl olarak varsayılan olarak kullanırız. dizgi
başlangıçTarihi Bütçenin başlangıç tarihi. dize (gerekli)

Filtre

Ad Açıklama Değer
Metre Kullanım kategorisi bütçeleri için zorunlu olan ölçümlerdeki (GUID) filtrelerin listesi. dizgi

Kısıtlama -ları:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
kaynak grupları Kaynak gruplarında yalnızca abonelik düzeyinde izin verilen filtrelerin listesi. dize[]
Kaynaklar Kaynaklardaki filtrelerin listesi. dize[]
Etiketler Etiketlerdeki filtrelerin sözlüğü. FiltrelerEtiketler

FiltrelerEtiketler

Ad Açıklama Değer

Bildirim

Ad Açıklama Değer
iletişimE-postalar Eşik aşıldığında bütçe bildirimini göndermek için e-posta adresleri. string[] (gerekli)
contactGroups (İletişim Grupları) Eşik aşıldığında bütçe bildirimi gönderilecek eylem grupları. dize[]
contactRoles Eşik aşıldığında bütçe bildirimini göndermek için ilgili kişi rolleri. dize[]
Etkin Bildirim etkinleştirildi veya etkinleştirilmedi. bool (gerekli)
operatör Karşılaştırma işleci. 'Eşit'
'Büyüktür'
'GreaterThanOrEqualTo' (gerekli)
eşik Bildirimle ilişkili eşik değeri. Maliyet eşiği aştığında bildirim gönderilir. Her zaman yüzdedir ve 0 ile 1000 arasında olmalıdır. int (gerekli)

ARM şablonu kaynak tanımı

Bütçe kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Kullanım Örnekleri

Azure Hızlı Başlangıç Şablonları

Aşağıdaki Azure Hızlı Başlangıç şablonları bu kaynak türünü dağıtmak.

Şablon Açıklama
bütçe oluşturma

Azure 'a dağıtma
Bu şablon, bir abonelik altında nasıl bütçe oluşturulacağını gösterir.
Filtre ile Bütçe Oluşturma

Azure 'a dağıtma
Bu şablon, bir abonelik altında nasıl bütçe oluşturulacağını gösterir.
Basit Bütçe Oluşturma

Azure 'a dağıtma
Bu şablon, bir abonelik altında nasıl bütçe oluşturulacağını gösterir.

Kaynak biçimi

Microsoft.Consumption/budgets kaynağı oluşturmak için şablonunuza aşağıdaki JSON dosyasını ekleyin.

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2018-10-01",
  "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"
    }
  }
}

Özellik Değerleri

Microsoft.Consumption/budgets

Ad Açıklama Değer
apiVersiyonu API sürümü '2018-10-01'
e-Etiket Kaynağın eTag'i. Eşzamanlı güncelleştirme senaryolarını işlemek için, kullanıcının en son sürümü güncelleştirip güncelleştirmediğini belirlemek için bu alan kullanılır. dizgi
ad Kaynak adı dize (gerekli)
Özellikler Bütçenin özellikleri. Bütçe Özellikleri
tür Kaynak türü 'Microsoft.Consumption/budgets'

Bütçe Özellikleri

Ad Açıklama Değer
miktar Bütçeyle izlenen toplam maliyet miktarı int (gerekli)
kategori Bütçenin maliyeti veya kullanımı izlediği bütçe kategorisi. 'Maliyet'
'Kullanım' (gerekli)
Filtre Bütçeleri kaynak grubuna, kaynağa veya ölçüme göre filtrelemek için kullanılabilir. Filtreleri
Bildirim Bütçeyle ilişkili bildirimlerin sözlüğü. Bütçede en fazla beş bildirim olabilir. BudgetPropertiesNotifications
zaman tahıl Bütçenin kapsadığı süre. Miktarın izlenmesi zaman dilimine göre sıfırlanır. 'Yıllık'
'Aylık'
'Üç aylık' (gerekli)
zaman Dilimi Bütçenin başlangıç ve bitiş tarihidir. Başlangıç tarihi ayın ilki olmalı ve bitiş tarihinden küçük olmalıdır. Bütçe başlangıç tarihi 1 Haziran 2017 tarihinde veya sonrasında olmalıdır. Gelecekteki başlangıç tarihi üç aydan uzun olmamalıdır. Geçmiş başlangıç tarihi, zaman dilimi içinde seçilmelidir. Bitiş tarihinde herhangi bir kısıtlama yoktur. BudgetTimePeriod (gerekli)

BudgetPropertiesNotifications

Ad Açıklama Değer

BudgetTimePeriod (Bütçe Süresi)

Ad Açıklama Değer
Bitiş Tarihi Bütçenin bitiş tarihi. Sağlanmadıysa, bunu başlangıç tarihinden itibaren 10 yıl olarak varsayılan olarak kullanırız. dizgi
başlangıçTarihi Bütçenin başlangıç tarihi. dize (gerekli)

Filtre

Ad Açıklama Değer
Metre Kullanım kategorisi bütçeleri için zorunlu olan ölçümlerdeki (GUID) filtrelerin listesi. dizgi

Kısıtlama -ları:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
kaynak grupları Kaynak gruplarında yalnızca abonelik düzeyinde izin verilen filtrelerin listesi. dize[]
Kaynaklar Kaynaklardaki filtrelerin listesi. dize[]
Etiketler Etiketlerdeki filtrelerin sözlüğü. FiltrelerEtiketler

FiltrelerEtiketler

Ad Açıklama Değer

Bildirim

Ad Açıklama Değer
iletişimE-postalar Eşik aşıldığında bütçe bildirimini göndermek için e-posta adresleri. string[] (gerekli)
contactGroups (İletişim Grupları) Eşik aşıldığında bütçe bildirimi gönderilecek eylem grupları. dize[]
contactRoles Eşik aşıldığında bütçe bildirimini göndermek için ilgili kişi rolleri. dize[]
Etkin Bildirim etkinleştirildi veya etkinleştirilmedi. bool (gerekli)
operatör Karşılaştırma işleci. 'Eşit'
'Büyüktür'
'GreaterThanOrEqualTo' (gerekli)
eşik Bildirimle ilişkili eşik değeri. Maliyet eşiği aştığında bildirim gönderilir. Her zaman yüzdedir ve 0 ile 1000 arasında olmalıdır. int (gerekli)

Terraform (AzAPI sağlayıcısı) kaynak tanımı

Bütçe kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Kullanım Örnekleri

Terraform Örnekleri

Tüketim Bütçesini dağıtmanın temel bir örneği.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "budget" {
  type      = "Microsoft.Consumption/budgets@2019-10-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  body = {
    properties = {
      amount   = 1000
      category = "Cost"
      filter = {
        tags = {
          name     = "foo"
          operator = "In"
          values   = ["bar"]
        }
      }
      notifications = {
        "Actual_EqualTo_90.000000_Percent" = {
          contactEmails = ["foo@example.com", "bar@example.com"]
          contactGroups = []
          contactRoles  = []
          enabled       = true
          operator      = "EqualTo"
          threshold     = 90
          thresholdType = "Actual"
        }
      }
      timeGrain = "Monthly"
      timePeriod = {
        startDate = "2025-08-01T00:00:00Z"
      }
    }
  }
}

Kaynak biçimi

Microsoft.Consumption/budgets kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2018-10-01"
  name = "string"
  parent_id = "string"
  body = {
    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"
      }
    }
  }
}

Özellik Değerleri

Microsoft.Consumption/budgets

Ad Açıklama Değer
e-Etiket Kaynağın eTag'i. Eşzamanlı güncelleştirme senaryolarını işlemek için, kullanıcının en son sürümü güncelleştirip güncelleştirmediğini belirlemek için bu alan kullanılır. dizgi
ad Kaynak adı dize (gerekli)
Özellikler Bütçenin özellikleri. Bütçe Özellikleri
tür Kaynak türü "Microsoft.Consumption/budgets@2018-10-01" (İngilizce)

Bütçe Özellikleri

Ad Açıklama Değer
miktar Bütçeyle izlenen toplam maliyet miktarı int (gerekli)
kategori Bütçenin maliyeti veya kullanımı izlediği bütçe kategorisi. 'Maliyet'
'Kullanım' (gerekli)
Filtre Bütçeleri kaynak grubuna, kaynağa veya ölçüme göre filtrelemek için kullanılabilir. Filtreleri
Bildirim Bütçeyle ilişkili bildirimlerin sözlüğü. Bütçede en fazla beş bildirim olabilir. BudgetPropertiesNotifications
zaman tahıl Bütçenin kapsadığı süre. Miktarın izlenmesi zaman dilimine göre sıfırlanır. 'Yıllık'
'Aylık'
'Üç aylık' (gerekli)
zaman Dilimi Bütçenin başlangıç ve bitiş tarihidir. Başlangıç tarihi ayın ilki olmalı ve bitiş tarihinden küçük olmalıdır. Bütçe başlangıç tarihi 1 Haziran 2017 tarihinde veya sonrasında olmalıdır. Gelecekteki başlangıç tarihi üç aydan uzun olmamalıdır. Geçmiş başlangıç tarihi, zaman dilimi içinde seçilmelidir. Bitiş tarihinde herhangi bir kısıtlama yoktur. BudgetTimePeriod (gerekli)

BudgetPropertiesNotifications

Ad Açıklama Değer

BudgetTimePeriod (Bütçe Süresi)

Ad Açıklama Değer
Bitiş Tarihi Bütçenin bitiş tarihi. Sağlanmadıysa, bunu başlangıç tarihinden itibaren 10 yıl olarak varsayılan olarak kullanırız. dizgi
başlangıçTarihi Bütçenin başlangıç tarihi. dize (gerekli)

Filtre

Ad Açıklama Değer
Metre Kullanım kategorisi bütçeleri için zorunlu olan ölçümlerdeki (GUID) filtrelerin listesi. dizgi

Kısıtlama -ları:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
kaynak grupları Kaynak gruplarında yalnızca abonelik düzeyinde izin verilen filtrelerin listesi. dize[]
Kaynaklar Kaynaklardaki filtrelerin listesi. dize[]
Etiketler Etiketlerdeki filtrelerin sözlüğü. FiltrelerEtiketler

FiltrelerEtiketler

Ad Açıklama Değer

Bildirim

Ad Açıklama Değer
iletişimE-postalar Eşik aşıldığında bütçe bildirimini göndermek için e-posta adresleri. string[] (gerekli)
contactGroups (İletişim Grupları) Eşik aşıldığında bütçe bildirimi gönderilecek eylem grupları. dize[]
contactRoles Eşik aşıldığında bütçe bildirimini göndermek için ilgili kişi rolleri. dize[]
Etkin Bildirim etkinleştirildi veya etkinleştirilmedi. bool (gerekli)
operatör Karşılaştırma işleci. 'Eşit'
'Büyüktür'
'GreaterThanOrEqualTo' (gerekli)
eşik Bildirimle ilişkili eşik değeri. Maliyet eşiği aştığında bildirim gönderilir. Her zaman yüzdedir ve 0 ile 1000 arasında olmalıdır. int (gerekli)