Azure Tüketim

Makale
02/03/2024

Azure Tüketim API'leri, Azure kaynaklarınızla ilgili maliyet ve kullanım verilerinize program aracılığıyla erişmenizi sağlar. API'ler şu anda yalnızca Kurumsal Kayıtları, Web Direct aboneliklerini (birkaç özel durum dışında) ve CSP Azure planı aboneliklerini desteklemektedir. API'ler diğer Azure abonelik türlerini desteklemek için sürekli güncelleştirilir.

Azure Tüketim API'leri şu verilere erişim sunar:

Yalnızca Kurumsal Müşteriler
- Fiyat listesi
- Bütçeler
- Tahminler
- Bakiyeler
- Etiketler
- Maliyet Etiketleri
Kurumsal ve Doğrudan Web Müşterileri
- Rezervasyon Ayrıntıları
- Rezervasyon Özetleri
- Market Ücretleri
- Kullanım Ayrıntıları
- Rezervasyon Önerileri

Desteklenmeyen Abonelik Türlerinin Listesi

MS-AZR-0145P (CSP)
MS-AZR-0146P (CSP)
MS-AZR-159P (CSP)
MS-AZR-0036P (sponsorlu)
MS-AZR-0143P (sponsorlu)
MS-AZR-0015P (iç)
MS-AZR-0144P (DreamSpark)

Faturalama dönemleri ve tarih aralıklarıyla çalışma

Kullanım Ayrıntıları ve Market Ücretleri , kullanım verilerinin başlangıç ve bitiş tarihlerini tanımlamak için faturalama dönemini veya tarih aralıklarını kabul eder.

Burada, istekteki faturalama dönemlerine ve tarih aralıklarına göre API davranışı verilmiştir.

fatura dönemi istekte var	İstekte başlangıç tarihi var	İstekte bitiş tarihi var	API davranışı
hayır	hayır	hayır	Geçerli faturalama dönemine ait veriler yanıt olarak döndürülür
hayır	evet	hayır	Geçerli faturalama dönemine ait veriler yanıt olarak döndürülür
hayır	hayır	evet	Geçerli faturalama dönemine ait veriler yanıt olarak döndürülür
hayır	evet	evet	Belirtilen Başlangıç ve Bitiş Tarihi verileri yanıt olarak döndürülür
evet	hayır	hayır	Belirtilen faturalama dönemine ait veriler yanıt olarak döndürülür
evet	evet	hayır	Belirtilen faturalama dönemine ait veriler yanıt olarak döndürülür
evet	hayır	evet	Belirtilen faturalama dönemine ait veriler yanıt olarak döndürülür
evet	evet	evet	Belirtilen Başlangıç ve Bitiş Tarihi verileri yanıt olarak döndürülür, sağlanan faturalama dönemi yoksayılır

İzin verilen maksimum tarih aralığı tek bir istekte 12 aydır ve veriler 1 Mayıs 2014 veya sonrasında kullanılabilir.

Faturalama dönemlerinin listesini alma

İstekte geçerli bir faturalama dönemi sağlamak için istemcinin önce aşağıdaki API'yi kullanarak aboneliğe göre kullanılabilir faturalama dönemlerinin listesini alması gerekir

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods?api-version=2017-04-24-preview

Bu listeyi kullanarak, istemci tüketim verilerini almak için belirli bir faturalama dönemini seçebilir.

Geç Gelen Veriler

Raporlama kullanımında gecikmeler olan üçüncü taraf hizmetleri barındırmak için, bildirilen kullanım tarihi, kullanım verilerinin gönderildiği zamana ayarlanır( kullanım süresi yerine) gerçek kullanımın gerçekleştiği zamana göre belirlenir.

Sonuç olarak, kullanım derecelendirilir ve bildirilen zamana uygulanır. Gerçek tüketim süresini temsil etmek için özellikler. AdditionalProperties alanı artık iki ek özellik içerecek. ConsumptionBeginTime ve ConsumptionEndTime , gerçek tüketim süresi penceresine karşılık gelen yeni alanlardır.

Bu değişiklikler, kullanım ayrıntıları API'sini çağırırken ele alınması gereken birkaç senaryoyla sonuçlanır:

Ay Sonu Raporlaması: Bir ay boyunca gerçekleşen ancak sonraki ay içinde bildirilen kullanım için, müşterilerin kullanımı uygun aya atamak için ekÖzellikler alanına bakmaları gerekir.
Sorgu Kullanımı ayrıntıları: Kullanım ayrıntıları API'sini bir tarih aralığına göre sorgularken, sorgu yalnızca kullanım raporu tarihi için geçerlidir; additionalProperties alanındaki tüketim süresi için geçerli değildir. Kullanım ayrıntılarını faturalarla eşlemek isteyen müşteriler için, fatura kullanım raporu tarihine göre kullanımı işleyeceğinden bu güncelleştirme işlemi etkilemez. Kullanım ayrıntılarını belirli bir takvim tarihi/ayıyla eşlemek isteyen müşteriler için, bu güncelleştirme hataya neden olan bir değişikliktir ve bu senaryolarda ekÖzellikler bölümünde kullanım raporu tarihi kullanılamaz ve kullanımın gerçekleştiği tarih kullanılmalıdır.

Ek Ayrıntılar için Örnek Çağrı:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/usageDetails?api-version=2018-03-31&$expand=properties/additionalProperties

Örnek Yanıt parçacığı:

  "properties": {
    "billingPeriodId":"/subscriptions/{subscriptionid}/providers/Microsoft.Billing/billingPeriods/20180501",
    "usageStart":"2018-05-01T00:00:00.0000000Z",
    "usageEnd":"2018-05-01T23:59:59.0000000Z",
    "instanceId":"/subscriptions/{subscriptionid}/resourceGroups/{resourcegroup}/providers/Microsoft.Cdn/profiles/{profile}",
    "instanceName":"{id}",
    "instanceLocation":"SouthCentralUS",
    "meterId":"6b88ada0-cbc0-4874-be0e-23004f8b4de7",
    "usageQuantity":0.002065,
    "pretaxCost":0,
    "currency":"USD",
    "additionalProperties": {
      "Provider": "1",
      "ConsumptionBeginTime": "2018-05-01T19:00:00",
      "ConsumptionEndTime": "2018-05-01T20:00:00"
    }
  }

Ayrıca bkz.

Bu API'yi dile özgü SDK'lardan birinde kullanma hakkında daha fazla bilgi için aşağıdakileri ziyaret edin

Azure Tüketim Python SDK'sı

Azure Tüketim CLI'si

Azure Tüketim NodeJS SDK'sı

Azure Tüketim Ruby SDK'sı

Aracılığıyla paylaş