Budgets - Get

Hizmet:: Consumption

API Sürümü:: 2024-08-01

Kapsamın bütçesini bütçe adına göre alır.

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/budgets/{budgetName}?api-version=2024-08-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
budgetName	path	True	string	Bütçe Adı.
scope	path	True	string	Kaynağın tam Azure Resource manager tanımlayıcısı.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	Budget	Azure işlemi başarıyla tamamlandı.
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Budget

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/budgets/TestBudget?api-version=2024-08-01

Örnek yanıt

Durum kodu:: 200

{
  "name": "TestBudget",
  "type": "Microsoft.Consumption/budgets",
  "eTag": "\"1d34d012214157f\"",
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Consumption/budgets/TestBudget",
  "properties": {
    "amount": 100.65,
    "category": "Cost",
    "currentSpend": {
      "amount": 80.89,
      "unit": "USD"
    },
    "filter": {
      "and": [
        {
          "dimensions": {
            "name": "ResourceId",
            "operator": "In",
            "values": [
              "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Compute/virtualMachines/MSVM2",
              "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Compute/virtualMachines/platformcloudplatformGeneric1"
            ]
          }
        },
        {
          "tags": {
            "name": "category",
            "operator": "In",
            "values": [
              "Dev",
              "Prod"
            ]
          }
        },
        {
          "tags": {
            "name": "department",
            "operator": "In",
            "values": [
              "engineering",
              "sales"
            ]
          }
        }
      ]
    },
    "notifications": {
      "Actual_GreaterThan_80_Percent": {
        "contactEmails": [
          "johndoe@contoso.com",
          "janesmith@contoso.com"
        ],
        "contactGroups": [
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/microsoft.insights/actionGroups/SampleActionGroup"
        ],
        "contactRoles": [
          "Contributor",
          "Reader"
        ],
        "enabled": true,
        "operator": "GreaterThan",
        "threshold": 80,
        "thresholdType": "Actual"
      }
    },
    "timeGrain": "Monthly",
    "timePeriod": {
      "endDate": "2018-10-31T00:00:00Z",
      "startDate": "2017-10-01T00:00:00Z"
    }
  }
}

Tanımlar

Name	Description
Budget	Bütçe kaynağı.
BudgetComparisonExpression	Bütçelerde kullanılacak karşılaştırma ifadesi.
BudgetFilter	Bütçeleri kaynak grubuna, kaynağa veya ölçüme göre filtrelemek için kullanılabilir.
BudgetFilterProperties	Bütçeyi filtrelemek için Boyutlar veya Etiketler.
BudgetOperatorType	Karşılaştırma için kullanılacak işleç.
BudgetTimePeriod	Bütçenin başlangıç ve bitiş tarihi.
CategoryType	Bütçenin maliyeti veya kullanımı izlediği bütçe kategorisi.
createdByType	Kaynağı oluşturan kimliğin türü.
CultureCode	Alıcının bildirimi alacağı dil
CurrentSpend	Bütçe için izlenen geçerli maliyet miktarı.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
ForecastSpend	Bütçe için izlenen tahmini maliyet.
Notification	Bütçeyle ilişkili bildirim.
OperatorType	Karşılaştırma işleci.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
ThresholdType	Eşik türü
TimeGrainType	Bütçenin kapsadığı süre. Miktarın izlenmesi zaman dilimine göre sıfırlanır. BillingMonth, BillingQuarter ve BillingAnnual yalnızca WD müşterileri tarafından desteklenir

Budget

Object

Bütçe kaynağı.

Name	Tür	Description
eTag	string	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.
id	string	Kaynağın tam kaynak kimliği. Örn - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Kaynağın adı
properties.amount	number (decimal)	Bütçeyle izlenen toplam maliyet miktarı
properties.category	CategoryType	Bütçenin maliyeti veya kullanımı izlediği bütçe kategorisi.
properties.currentSpend	CurrentSpend	Bütçe için izlenen geçerli maliyet miktarı.
properties.filter	BudgetFilter	Bütçeleri kullanıcı tarafından belirtilen boyutlara ve/veya etiketlere göre filtrelemek için kullanılabilir.
properties.forecastSpend	ForecastSpend	Bütçe için izlenen tahmini maliyet.
properties.notifications	<string, Notification>	Bütçeyle ilişkili bildirimlerin sözlüğü. Bütçede en fazla beş bildirim olabilir.
properties.timeGrain	TimeGrainType	Bütçenin kapsadığı süre. Miktarın izlenmesi zaman dilimine göre sıfırlanır. BillingMonth, BillingQuarter ve BillingAnnual yalnızca WD müşterileri tarafından desteklenir
properties.timePeriod	BudgetTimePeriod	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 on iki aydan uzun olmamalıdır. Geçmiş başlangıç tarihi, zaman dilimi içinde seçilmelidir. Bitiş tarihinde herhangi bir kısıtlama yoktur.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

BudgetComparisonExpression

Object

Bütçelerde kullanılacak karşılaştırma ifadesi.

Name	Tür	Description
name	string	Karşılaştırmada kullanılacak sütunun adı.
operator	BudgetOperatorType	Karşılaştırma için kullanılacak işleç.
values	string[]	Karşılaştırma için kullanılacak değer dizisi

BudgetFilter

Object

Bütçeleri kaynak grubuna, kaynağa veya ölçüme göre filtrelemek için kullanılabilir.

Name	Tür	Description
and	BudgetFilterProperties[]	Mantıksal "AND" ifadesi. En az 2 öğe olmalıdır.
dimensions	BudgetComparisonExpression	Boyut için karşılaştırma ifadesi var
tags	BudgetComparisonExpression	Etiket için karşılaştırma ifadesi var

BudgetFilterProperties

Object

Bütçeyi filtrelemek için Boyutlar veya Etiketler.

Name	Tür	Description
dimensions	BudgetComparisonExpression	Boyut için karşılaştırma ifadesi var
tags	BudgetComparisonExpression	Etiket için karşılaştırma ifadesi var

BudgetOperatorType

Listeleme

Karşılaştırma için kullanılacak işleç.

Değer	Description
In

BudgetTimePeriod

Object

Bütçenin başlangıç ve bitiş tarihi.

Name	Tür	Description
endDate	string (date-time)	Bütçenin bitiş tarihi. Sağlanmadıysa, bunu başlangıç tarihinden itibaren 10 yıl olarak varsayılan olarak kullanırız.
startDate	string (date-time)	Bütçenin başlangıç tarihi.

CategoryType

Listeleme

Bütçenin maliyeti veya kullanımı izlediği bütçe kategorisi.

Değer	Description
Cost

createdByType

Listeleme

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

CultureCode

Listeleme

Alıcının bildirimi alacağı dil

Değer	Description
en-us
ja-jp
zh-cn
de-de
es-es
fr-fr
it-it
ko-kr
pt-br
ru-ru
zh-tw
cs-cz
pl-pl
tr-tr
da-dk
en-gb
hu-hu
nb-no
nl-nl
pt-pt
sv-se

CurrentSpend

Object

Bütçe için izlenen geçerli maliyet miktarı.

Name	Tür	Description
amount	number (decimal)	Bütçe tarafından izlenen toplam maliyet miktarı.
unit	string	Bütçe tutarı için ölçü birimi.

ErrorAdditionalInfo

Object

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Object

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Object

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

ForecastSpend

Object

Bütçe için izlenen tahmini maliyet.

Name	Tür	Description
amount	number (decimal)	Bütçe tarafından izlenen toplam zaman aralığı için tahmin edilen maliyet. Bu değer yalnızca bütçe bir tahmin uyarı türü içeriyorsa sağlanır.
unit	string	Bütçe tutarı için ölçü birimi.

Notification

Object

Bütçeyle ilişkili bildirim.

Name	Tür	Default value	Description
contactEmails	string[]		Eşik aşıldığında bütçe bildirimini göndermek için e-posta adresleri. Abonelik veya Kaynak Grubu kapsamlarında belirtilen en az bir kişi e-postası veya kişi grubu olmalıdır. Diğer tüm kapsamlarda en az bir kişi e-postası belirtilmelidir.
contactGroups	string[]		Eşik aşıldığında bütçe bildirimi gönderilecek eylem grupları. Tam azure kaynak kimliği olarak sağlanmalıdır. Yalnızca Abonelik veya Kaynak Grubu kapsamlarında desteklenir.
contactRoles	string[]		Eşik aşıldığında bütçe bildirimini göndermek için ilgili kişi rolleri.
enabled	boolean		Bildirim etkinleştirildi veya etkinleştirilmedi.
locale	CultureCode		Alıcının bildirimi alacağı dil
operator	OperatorType		Karşılaştırma işleci.
threshold	number (decimal)		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.
thresholdType	ThresholdType	Actual	Eşik türü

OperatorType

Listeleme

Karşılaştırma işleci.

Değer	Description
EqualTo	Değerlendirilen maliyet eşik değeriyle aynıysa uyarı tetiklenir. Not: Maliyetin eşik değeriyle tam olarak aynı olma olasılığı düşük olduğundan uyarınızın eksik olmasına neden olduğundan bu OperatorType'ın kullanılması önerilmez. Bu OperatorType gelecekte kullanımdan kaldırılacaktır.
GreaterThan	Değerlendirilen maliyet eşik değerinden büyükse uyarı tetiklenir. Not: Bütçe Uyarısı yapılandırılırken önerilen OperatorType budur.
GreaterThanOrEqualTo	Değerlendirilen maliyet eşik değerinden büyük veya buna eşitse uyarı tetiklenir.

systemData

Object

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

ThresholdType

Listeleme

Eşik türü

Değer	Description
Actual	Gerçek maliyetler bütçe uyarıları, tahakkuk eden gerçek maliyet ayrılan bütçeyi aştığında bunu bildirir.
Forecasted	Tahmin edilen maliyet bütçe uyarıları, tahmin edilen maliyet tahminlerine bağlı olduğundan harcama eğilimlerinizin ayrılmış bütçenizi aşma olasılığının yüksek olduğunu belirten gelişmiş bildirim sağlar.

TimeGrainType

Listeleme

Bütçenin kapsadığı süre. Miktarın izlenmesi zaman dilimine göre sıfırlanır. BillingMonth, BillingQuarter ve BillingAnnual yalnızca WD müşterileri tarafından desteklenir

Değer	Description
Monthly
Quarterly
Annually
BillingMonth
BillingQuarter
BillingAnnual

Aracılığıyla paylaş

Budgets - Get

URI Parametreleri

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

Budget

Örnek isteği

Örnek yanıt

Tanımlar

Budget

BudgetComparisonExpression

BudgetFilter

BudgetFilterProperties

BudgetOperatorType

BudgetTimePeriod

CategoryType

createdByType

CultureCode

CurrentSpend

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ForecastSpend

Notification

OperatorType

systemData

ThresholdType

TimeGrainType